IClientSecurity::QueryBlanket

9/8/2008

Este método recupera informações sobre autenticação o cliente usa para fazer chamadas no proxy especificado.

Syntax

HRESULT QueryBlanket(
  IUnknown* pProxy,
  DWORD* pAuthnSvc,
  DWORD* pAuthzSvc,
  OLECHAR** pServerPrincName,
  DWORD* pAuthnLevel,
  DWORD* pImpLevel,
  RPC_AUTH_IDENTITY_HANDLE* pAuthInfo, 
  DWORD* pCapabilities 
);

Parameters

• pProxy
  [no] Ponteiro indicando o proxy para consulta.

  Ele não pode ser NULL.

  Para obter mais informações, consulte a seção " Comentários ".

• pAuthnSvc
  [out] Ponteiro para um valor DWORD definindo o atual serviço autenticação.

  Este é um único valor extraído a lista de RPC_C_AUTHN_XXX Constantes.

  Se o chamador especifica NULL, a atual serviço autenticação não é recuperado.

• pAuthzSvc
  [out] Ponteiro para um valor DWORD definindo o atual serviço autorização.

  Este é um único valor extraído a lista de RPC_C_AUTHZ_XXX Constantes.

  Se o chamador especifica NULL, a atual serviço autorização não é recuperado.

• pServerPrincName
  [out] Ponteiro para o atual principal nome.

  O seqüência de caracteres é alocado pelo receptor usando CoTaskMemAlloc e deve ser liberada pelo chamador usando CoTaskMemFree Quando eles são feitos com ele.

  O real principal nome é retornado.

  Se o chamador especifica NULL, a atual principal nome não for recuperado.

• pAuthnLevel
  [out] Ponteiro para um valor DWORD definindo o atual nível de autenticação.

  Este é um único valor extraído a lista de RPC_C_AUTHN_LEVEL_XXX Constantes.

  Se o chamador especifica NULL, a atual nível de autenticação não é recuperado.

• pImpLevel
  [out] Ponteiro para um valor DWORD definindo o atual representação nível.

  Este é um único valor extraído a lista de RPC_C_IMP_LEVEL_XXX Constantes.

  Se o chamador especifica NULL, a atual representação nível não é recuperado.

  Ao usar NTLMSSP, esse valor pode ser RPC_IMP_LEVEL_IDENTIFY ou RPC_IMP_LEVEL_IMPERSONATE.

  Ao usar Kerberos, ele pode ser RPC_IMP_LEVEL_IDENTIFY, RPC_IMP_LEVEL_IMPERSONATE ou RPC_C_IMP_LEVEL_DELEGATE.

• pAuthInfo
  [out] Ponteiro para um identificador que indica a identidade do cliente que foi passado to the last IClientSecurity::SetBlanket chamar (ou o valor usar como padrão).

  Valores padrão são somente válido até que o proxy é lançada.

  Se o chamador especifica NULL, a identidade cliente não é recuperada.

  O formato da estrutura que se refere a identificador retornado depende de como o serviço autenticação.

  Para NTLMSSP e Kerberos, se o cliente especificou uma estrutura na pAuthInfo parâmetro para CoInitializeSecurity, que valor será retornado. Porque isso aponta para o valor próprio e não é um copiar, ele não deve ser manipulado ou liberado.

• pCapabilities
  [out] Ponteiro para uma DWORD de sinalizadores indicando as capacidades do proxy.

  Pode ser NULL, no qual maiúsculas e minúsculas os sinalizadores não são recuperados.

  Para Windows 2000, elas podem ser EOAC_STATIC_CLOAKING ou EOAC_DYNAMIC_CLOAKING.

  Se o chamador especifica NULL, a atual sinalizadores funcionalidade não são recuperados.

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

IClientSecurity::QueryBlanket é chamado, o cliente para recuperar o informações sobre autenticação COM usará em chamadas feitas a partir de proxy interface especificada.

Com um ponteiro para uma interface em de proxy, o cliente deve primeiro chamar Falha de QueryInterface Para um ponteiro para IClientSecurity; Em seguida, com esse ponteiro, o cliente poderia chamar IClientSecurity::QueryBlanket, seguidos liberar o ponteiro. Essa seqüência de chamadas é encapsulada na função auxiliar CoQueryProxyBlanket.

Em pProxy, você transmitir um ponteiro interface. No entanto, você não pode transmitir um ponteiro para uma interface que não usa um proxy. Assim, você não pode transmitir um ponteiro para uma interface que possui o local palavra-chave em sua definição interface porque nenhum proxy é criado para tal uma interface. IUnknown é a exceção a essa regra.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib, uuid.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CoQueryProxyBlanket