CoQueryClientBlanket
9/8/2008
Essa função é chamado, o servidor para localizar saída sobre o cliente que chamado o método Executar na atual segmento.
Syntax
HRESULT CoQueryClientBlanket(
DWORD* pAuthnSvc,
DWORD* pAuthzSvc,
OLECHAR** pServerPrincName,
DWORD* pAuthnLevel,
DWORD* pImpLevel,
RPC_AUTHZ_HANDLE* pPrivs,
DWORD** pCapabilities
);
Parameters
- pAuthnSvc
[out] Ponteiro para um DWORD valor definindo o atual serviço autenticação. Esse será um único valor extraído a lista de RPC_C_AUTHN_XXX Constantes. Pode ser NULL, no qual maiúsculas e minúsculas o atual serviço autenticação não é retornado.
- pAuthzSvc
[out] Ponteiro para um DWORD valor definindo o atual serviço autorização. Esse será um único valor extraído a lista de RPC_C_AUTHZ_XXX Constantes. Pode ser NULL, no qual maiúsculas e minúsculas o atual serviço autorização não é retornado.
pServerPrincName
[out] Ponteiro para o atual principal nome. O seqüência de caracteres serão alocada pelo receptor usando CoTaskMemAlloc e deve ser liberada pelo chamador usando CoTaskMemFree Quando eles são feitos com ele. Pode ser NULL, no qual maiúsculas e minúsculas o principal nome não é retornado.Por padrão, SSL principal nomes serão na forma de msstd. A forma fullsic será retornada se EOAC_MAKE_FULLSIC for especificado no parâmetro de pCapabilities. Para obter mais informações sobre msstd e fullsic, consulte a seção SSL de COM e Security Packages.
- pAuthnLevel
[out] Ponteiro para um DWORD valor definindo o atual nível de autenticação. Esse será um único valor extraído a lista de RPC_C_AUTHN_LEVEL_XXX Constantes. Pode ser NULL, no qual maiúsculas e minúsculas o atual nível de autenticação não é retornado.
- pImpLevel
[out] Deve ser NULL. Este parâmetro é reservado para uso futuro.
pPrivs
[out] Ponteiro para um identificador que indica as informações privilégio para o aplicativo cliente. O formato da estrutura que o identificador se refere depende de como o serviço autenticação.O aplicativo não deve gravar ou a memória livre.
As informações é válido apenas para a duração do atual chamar.
NULL pode ser retornado, em que maiúsculas e minúsculas as informações privilégio não são retornadas.
Para NTLMSSP e Kerberos, esse é principal do cliente nome.
- pCapabilities
[in, Out] Ponteiro para retornar sinalizadores indicando recursos do chamar. Pode ser NULL, no qual maiúsculas e minúsculas os sinalizadores indicando recursos não são retornados.
Return Value
- S_OK
O sucesso.
- E_INVALIDARG
Um ou mais argumentos estão inválido.
- E_OUTOFMEMORY
Memória insuficiente para criar o pServerPrincName Saída-parâmetro.
Remarks
CoQueryClientBlanket é chamado, o servidor para get informações de segurança sobre o cliente que chamado o método Executar na atual segmento. Essa função encapsula a seguinte seqüência de comum chama (manipulação de erro excluídos).
CoGetCallContext(IID_IServerSecurity, (void**)&pss);
pss->QueryBlanket(pAuthnSvc, pAuthzSvc, pServerPrincName,
pAuthnLevel, pImpLevel, pPrivs, pCapabilities);
pss->Release();
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
Header | objbase.h |
Library | ole32.lib |
Windows Embedded CE | Windows CE 3.0 and later |
Windows Mobile | Windows Mobile Version 5.0 and later |