Win32 API
MSDN 설명서 활용

소개

비고

사용 가능한 문서 유형

MSDN 라이브러리에는 기능을 구현하는 데 사용할 수있는 여러 가지 유형의 설명서가 들어 있습니다.

• 주제 개요 API에 대한 일반적인 이해를 돕기위한 주제에 대한 폭 넓은 개요입니다. 또한 이러한 개요에는 모범 사례 및 구현 전략에 대한 개요가 포함되어 있습니다.
• 샘플 특정 API의 사용을 보여줍니다. 이들은 일반적으로 매우 단순하며 오류 검사를 반드시 수행하지는 않으며 일반적으로 MFC 또는 ATL과 같은 프레임 워크를 사용하지 않습니다. 기능을 사용하기위한 출발점을 제공합니다.
• Reference 각 API의 모든 요소를 ​​자세히 설명합니다. 여기에는 상수 / 열거, 인터페이스, 함수 및 클래스가 포함됩니다.

참고 : 많은 Microsoft 직원도 Raymond Chen의 The Old New Thing 과 같은 문서를 보완 할 수있는 블로그를 보유하고 있지만이 블로그는 설명서 대신 사용할 수 있습니다.

지형지 물에 대한 문서 찾기

기능에 대한 문서 찾기는 좋은 검색 엔진을 사용하는 검색처럼 간단합니다. 실패하거나 특정 용어에 대해 확실하지 않은 경우 Windows API 색인 을 통해 특정 기능을 찾을 수 있습니다. 메소드, 인터페이스, 열거 형 및 상수에 대한 문서는 일반적으로 검색 엔진을 사용하여 이름을 검색하여 찾을 수 있습니다. 또한 Windows Dev Center 는 중요한 출발점을 제공 할 수 있습니다.

함수 문서 사용

함수에 대한 문서는 여러 섹션으로 나뉩니다.

개요

함수의 용도를 설명합니다. 이 섹션에서는 함수가 감가 상각되는지 여부에 대한 정보도 표시하거나 이후 버전에서는 사용할 수 없습니다.

통사론

적절한 소스 헤더에서 함수의 선언을 표시합니다. 함수의 서명에 대한 빠른 참조입니다.

매개 변수

매개 변수의 입력 또는 출력 여부와 기타 중요한 고려 사항에 대해 설명합니다.

반환 값

이 절에서는 오류를 _ 견하는 f}과 g 용 가능한 추가 정보를 포함하여 함수 호출의 결과에 대해 설명합니다. 예를 들어,이 섹션에서는 GetLastError 가 추가 오류 처리 정보를 제공하는지 명시 적으로 설명합니다.

비고

지원 기능에 대한 정보, 적절한 핸들링 확보 및 자원 처분과 같은 기능 사용에 필요한 추가 정보를 모두 포함합니다.

예제들

이 섹션을 사용할 수있는 경우 구현의 시작점으로 사용할 함수를 적절히 사용하는 예가 있습니다.

요구 사항

함수를 호출하기위한 전제 조건에 대한 중요한 정보를 제공합니다. 이 정보에는 다음이 포함됩니다.

• 최소 지원 클라이언트 / 서버 기능을 제공하는 운영 체제의 첫 번째 버전 (Microsoft에서 지원).
  _{(이 필드는 악의적 인 오해의 소지가 있습니다. 종종 이전 버전의 운영 체제에서는 함수가 지원되지만이 필드는 Microsoft에서 현재 지원 하는 가장 빠른 버전 만 표시합니다 (예 : CreateWindow 함수는 Windows 1.0부터 지원됨). 하지만 문서는이 Windows 2000의 모든 기능이 있었다하더라도 많은 불구하고, 2000 년 이전의 Windows 버전에서 지원되었다는 것을 표시하지 않는 MSDN 문서의 온라인 버전부터 지원 된 것을 알 수있다. 기존의 개발을 위해, 당신은 것입니다 MSDN CD-ROM에서 제공되는 것과 같은 이전 버전의 SDK 설명서를 참조하거나 헤더 파일을 살펴보십시오.}
• 헤더 함수 선언이 포함 된 #include 대한 SDK 헤더입니다. 헤더에서 함수를 사용할 수없는 경우이 함수를 호출하는 프로 시저에 대한 정보가 표시됩니다 (일반적으로 GetProcAddress 를 호출하여 런타임 동적 연결을 수행합니다).
• 라이브러리 내 보낸 함수를 해결하기 위해 링커에 전달할 라이브러리 파일입니다.
• DLL 내 보낸 기능을 포함하는 파일 (운영 체제와 함께 제공됨).
• 클라이언트 / 서버 지원 종료 API를 공식적으로 지원하는 마지막 버전의 Windows.
• 유니 코드 및 ANSI 이름 유니 코드 및 ANSI 변형을 모두 포함하는 문자열 함수의 경우 두 함수의 실제 내보내는 이름을 나열합니다. 이것은 대개 W 또는 A 접미사가있는 함수 이름입니다 (각각).