IServerSecurity::QueryBlanket 메서드(objidl.h)

서버의 메서드 중 하나를 호출한 클라이언트에 대한 정보를 검색합니다.

구문

HRESULT QueryBlanket(
  [out]     DWORD   *pAuthnSvc,
  [out]     DWORD   *pAuthzSvc,
  [out]     OLECHAR **pServerPrincName,
  [out]     DWORD   *pAuthnLevel,
  [out]     DWORD   *pImpLevel,
  [out]     void    **pPrivs,
  [in, out] DWORD   *pCapabilities
);

매개 변수

[out] pAuthnSvc

현재 인증 서비스에 대한 포인터입니다. 인증 서비스 상수 목록에서 가져온 단일 값입니다. 호출자가 NULL을 지정하면 현재 인증 서비스가 검색되지 않습니다.

[out] pAuthzSvc

현재 권한 부여 서비스를 수신하는 변수에 대한 포인터입니다. 권한 부여 상수 목록에서 단일 값이 됩니다. 호출자가 NULL을 지정하는 경우 현재 권한 부여 서비스가 검색되지 않습니다.

[out] pServerPrincName

현재 보안 주체 이름입니다. 이 문자열은 CoTaskMemAlloc를 사용하여 호출 수신자가 할당하며, CoTaskMemFree를 사용하여 호출자가 해제해야 합니다. 기본적으로 Schannel 보안 주체 이름은 msstd 형식입니다. EOAC_MAKE_FULLSIC pCapabilities 매개 변수에 지정된 경우 fullsic 양식이 반환됩니다. msstd 및 fullsic 양식에 대한 자세한 내용은 보안 주체 이름을 참조하세요. 호출자가 NULL을 지정하면 현재 보안 주체 이름이 검색되지 않습니다.

[out] pAuthnLevel

현재 인증 수준을 수신하는 변수에 대한 포인터입니다. 인증 수준 상수 목록에서 가져온 단일 값입니다. 호출자가 NULL을 지정하는 경우 현재 인증 수준이 검색되지 않습니다.

[out] pImpLevel

이 매개 변수는 NULL이어야 합니다.

[out] pPrivs

클라이언트 애플리케이션에 대한 권한 정보입니다. 핸들이 참조하는 구조체의 형식은 인증 서비스에 따라 달라집니다. 애플리케이션은 메모리를 쓰거나 해제해서는 안 됩니다. 정보는 현재 호출 기간 동안에만 유효합니다. NTLMSSP 및 Kerberos의 경우 SEC_WINNT_AUTH_IDENTITY 또는 SEC_WINNT_AUTH_IDENTITY_EX 구조입니다. Schannel의 경우 클라이언트의 인증서를 나타내는 CERT_CONTEXT 구조입니다. 클라이언트에 인증서가 없으면 NULL 이 반환됩니다. 호출자가 NULL을 지정하면 현재 권한 정보가 검색되지 않습니다.

[in, out] pCapabilities

호출의 기능입니다. Schannel이 인증 서비스인 경우 보안 주체 이름을 전체 형식으로 반환하도록 요청하려면 호출자가 이 매개 변수에서 EOAC_MAKE_FULLSIC 플래그를 설정할 수 있습니다. 호출자가 NULL을 지정하면 현재 기능이 검색되지 않습니다.

반환 값

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

설명

QueryBlanket 은 서버에서 메서드 중 하나를 호출한 클라이언트에 대해 알아내는 데 사용됩니다. 현재 스레드에서 현재 호출에 대한 IServerSecurity 에 대한 포인터를 얻으려면 CoGetCallContext를 호출하고 IID_IServerSecurity 지정합니다. 이 인터페이스 포인터는 호출 기간 동안 호출과 동일한 아파트에서만 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	objidl.h(ObjIdl.h 포함)

추가 정보

CoQueryClientBlanket

CoQueryProxyBlanket

IServerSecurity