FaxGetLoggingCategoriesW 함수(winfax.h)

아티클
11/20/2024

FaxGetLoggingCategories 함수는 클라이언트가 연결된 팩스 서버에 대한 현재 로깅 범주를 팩스 클라이언트 애플리케이션으로 반환합니다. 로깅 범주는 팩스 서버가 애플리케이션 이벤트 로그에 기록하는 오류 또는 기타 이벤트를 결정합니다.

통사론

WINFAXAPI BOOL FaxGetLoggingCategoriesW(
  [in]  HANDLE             FaxHandle,
  [out] PFAX_LOG_CATEGORYW *Categories,
  [out] LPDWORD            NumberCategories
);

매개 변수

[in] FaxHandle

형식: HANDLE

FaxConnectFaxServer 함수에 대한 호출에서 반환되는 팩스 서버 핸들을 지정합니다.

[out] Categories

형식: PFAX_LOG_CATEGORY*

FAX_LOG_CATEGORY 구조의 배열을 수신하는 버퍼의 주소에 대한 포인터입니다. 각 구조는 하나의 현재 로깅 범주를 설명합니다. 데이터에는 로깅 범주의 설명이 포함된 이름, 범주 번호 및 현재 로깅 수준이 포함됩니다.

미리 정의된 로깅 범주 및 로깅 수준에 대한 설명은 FAX_LOG_CATEGORY 항목을 참조하세요. 메모리 할당에 대한 자세한 내용은 다음 설명 섹션을 참조하세요.

[out] NumberCategories

형식: LPDWORD

Categories 매개 변수에서 함수가 반환하는 FAX_LOG_CATEGORY 구조의 수를 수신하는 DWORD 변수에 대한 포인터입니다.

반환 값

형식: BOOL

함수가 성공하면 반환 값은 0이 아닌 값입니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 얻으려면 GetLastError호출합니다. GetLastError는 다음 오류 중 하나를 반환할 수 있습니다.

반환 코드	묘사
ERROR_ACCESS_DENIED	액세스가 거부되었습니다. FAX_CONFIG_QUERY 액세스가 필요합니다.
ERROR_INVALID_PARAMETER	범주, NumberCategories또는 FaxHandle 매개 변수 중 하나 또는 전부는 NULL.
ERROR_NOT_ENOUGH_MEMORY	메모리 할당 중에 오류가 발생했습니다.

발언

팩스 클라이언트 애플리케이션은 일반적으로 FaxGetLoggingCategories 함수를 호출하여 팩스 서버에 대한 현재 로깅 범주 및 로깅 수준을 쿼리합니다. 현재 로깅 범주 및 수준을 수정하려면 FaxSetLoggingCategories 함수를 호출합니다.

FaxGetLoggingCategories 함수는 Categories 매개 변수가 가리키는 FAX_LOG_CATEGORY 버퍼 배열에 필요한 메모리를 할당합니다. 애플리케이션은 이 매개 변수와 연결된 리소스의 할당을 취소하려면 FaxFreeBuffer 함수를 호출해야 합니다.

자세한 내용은 로깅 범주 관리 및 팩스 리소스해제를 참조하세요.

메모

winfax.h 헤더는 FaxGetLoggingCategories를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winfax.h
라이브러리	WinFax.lib