Método ICredentialProviderUser::GetStringValue (credentialprovider.h)

  • Artigo

Recupera propriedades de cadeia de caracteres do objeto ICredentialProviderUser com base no valor de entrada.

Sintaxe

HRESULT GetStringValue(
  [in]  REFPROPERTYKEY key,
  [out] LPWSTR         *stringValue
);

Parâmetros

[in] key

Um dos valores a seguir que especificam a propriedade a ser recuperada.

REFPROPERTYKEY Descrição Aplica-se a...
PKEY_Identity_DisplayName O nome de usuário amigável. Interface do usuário de logon e interface do usuário de credencial
PKEY_Identity_LogonStatusString Uma cadeia de caracteres localizada que indica que o usuário está conectado status. Somente interface do usuário de logon
PKEY_Identity_PrimarySid O SID do usuário. Interface do usuário de logon e interface do usuário de credencial
PKEY_Identity_ProviderID A ID do provedor do usuário. Interface do usuário de logon e interface do usuário de credencial
PKEY_Identity_QualifiedUserName O nome usado para empacotar um buffer de autenticação. Interface do usuário de logon e interface do usuário de credencial
PKEY_Identity_UserName O nome do usuário. Interface do usuário de logon e interface do usuário de credencial

[out] stringValue

O endereço de um ponteiro para um buffer que, quando esse método retorna com êxito, recebe a cadeia de caracteres solicitada.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Cada um desses valores também pode ser recuperado como UM PROPVARIANT por meio de ICredentialProviderUser::GetValue.

Considere um cenário com os usuários a seguir.

  • Usuário de domínio:
    • Domínio: contoso
    • Nome de usuário: lisa
    • Nome amigável: Lisa Andrews
  • Usuário local:
    • Nome do computador: lisa-pc
    • Nome de usuário: lisa
    • Nome amigável: Lisa Andrews
  • Conta Microsoft:
    • Endereço de email: lisa@contoso.com
    • Nome amigável: Lisa Andrews
Nesse cenário, a tabela a seguir fornece alguns dados de exemplo para cada um dos valores de chave .
REFPROPERTYKEY Usuário de domínio Usuário local Conta da Microsoft
PKEY_Identity_DisplayName "Lisa Andrews" "Lisa Andrews" "Lisa Andrews"
PKEY_Identity_LogonStatusString "Conectado" "Bloqueado" "Conectado remotamente de lisa-pc"
PKEY_Identity_PrimarySid "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}" "{S-1-5-21-2279990834-2601404236-735077814-1001}"
PKEY_Identity_ProviderID "{A198529B-730F-4089-B646-A12557F5665E}" "{A198529B-730F-4089-B646-A12557F5665E}" Não predefinido
PKEY_Identity_QualifiedUserName "contoso\lisa" "lisa-pc\lisa" "<nome> do provedor de conta\lisa@contoso.com"
PKEY_Identity_UserName "contoso\lisa" "Lisa" "lisa@contoso.com"

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho credentialprovider.h
Biblioteca CredentialProvider.lib
DLL Authui.dll

Confira também

ICredentialProviderUser

ICredentialProviderUser::GetValue