CoQueryAuthenticationServices 함수(combaseapi.h)

  • 아티클

CoInitializeSecurity라는 프로세스가 있을 때 등록된 인증 서비스 목록을 검색합니다.

구문

HRESULT CoQueryAuthenticationServices(
  [out] DWORD                       *pcAuthSvc,
  [out] SOLE_AUTHENTICATION_SERVICE **asAuthSvc
);

매개 변수

[out] pcAuthSvc

asAuthSvc 배열에 반환된 항목 수를 수신하는 변수에 대한 포인터입니다.

[out] asAuthSvc

SOLE_AUTHENTICATION_SERVICE 구조체 배열에 대한 포인터입니다. 목록은 CoTaskMemAlloc 함수 호출을 통해 할당됩니다. 호출자는 CoTaskMemFree 함수를 호출하여 작업을 마치면 목록을 해제해야 합니다.

반환 값

이 함수는 표준 반환 값 E_INVALIDARG, E_OUTOFMEMORY 및 S_OK 반환할 수 있습니다.

설명

CoQueryAuthenticationServices 는 현재 등록된 인증 서비스 목록을 검색합니다. 프로세스가 CoInitializeSecurity를 호출하는 경우 이러한 서비스는 해당 호출을 통해 등록된 서비스입니다. 애플리케이션이 호출하지 않으면 인터페이스가 마샬링되거나 마즈샬링되지 않은 경우 COM에서 CoInitializeSecurity 가 자동으로 호출되어 기본 보안 패키지를 등록합니다.

이 함수는 CoInitializeSecurity에 등록된 인증 서비스만 반환합니다. 컴퓨터에 설치된 모든 인증 서비스를 반환하지는 않지만 EnumerateSecurityPackages는 반환합니다 . CoQueryAuthenticationServices 는 사용자 지정 마샬러가 애플리케이션에서 사용할 수 있는 보안 주체 이름을 결정하는 데 주로 유용합니다.

인증 서비스는 서로 다른 수준의 보안을 지원합니다. 예를 들어 NTLMSSP는 Kerberos가 수행하는 동안 위임 또는 상호 인증을 지원하지 않습니다. 애플리케이션은 애플리케이션에 필요한 기능을 제공하는 인증 서비스 등록만 담당합니다. 이 함수는 CoInitializeSecurity에 등록된 서비스를 확인하는 방법을 제공합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 combaseapi.h(Objbase.h 포함)
라이브러리 Ole32.lib
DLL Ole32.dll

추가 정보

CoInitializeSecurity

SOLE_AUTHENTICATION_SERVICE

COM의 보안