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

See Also

Reference

COM Functions
IServerSecurity::QueryBlanket