Compartir a través de

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

  • Artículo

Recupera las propiedades de cadena del objeto ICredentialProviderUser en función del valor de entrada.

Sintaxis

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

Parámetros

[in] key

Uno de los siguientes valores que especifican la propiedad que se va a recuperar.

REFPROPERTYKEY Descripción Se aplica a...
PKEY_Identity_DisplayName Nombre de usuario descriptivo. Interfaz de usuario de inicio de sesión y interfaz de usuario de credenciales
PKEY_Identity_LogonStatusString Cadena localizada que indica el estado de inicio de sesión del usuario. Solo interfaz de usuario de inicio de sesión
PKEY_Identity_PrimarySid SID del usuario. Interfaz de usuario de inicio de sesión y interfaz de usuario de credenciales
PKEY_Identity_ProviderID Identificador de proveedor del usuario. Interfaz de usuario de inicio de sesión y interfaz de usuario de credenciales
PKEY_Identity_QualifiedUserName Nombre que se usa para empaquetar un búfer de autenticación. Interfaz de usuario de inicio de sesión y interfaz de usuario de credenciales
PKEY_Identity_UserName Nombre de usuario. Interfaz de usuario de inicio de sesión y interfaz de usuario de credenciales

[out] stringValue

La dirección de un puntero a un búfer que, cuando este método devuelve correctamente, recibe la cadena solicitada.

Valor devuelto

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Cada uno de estos valores también se puede recuperar como PROPVARIANT a través de ICredentialProviderUser::GetValue.

Considere un escenario con los siguientes usuarios.

  • Usuario del dominio:
    • Dominio: contoso
    • Nombre de usuario: lisa
    • Nombre descriptivo: Lisa Andrews
  • Usuario local:
    • Nombre del equipo: lisa-pc
    • Nombre de usuario: lisa
    • Nombre descriptivo: Lisa Andrews
  • Cuenta de Microsoft:
    • Dirección de correo electrónico: lisa@contoso.com
    • Nombre descriptivo: Lisa Andrews
En este escenario, en la tabla siguiente se proporcionan algunos datos de ejemplo para cada uno de los valores de clave .
REFPROPERTYKEY Usuario de dominio Usuario local Cuenta Microsoft
PKEY_Identity_DisplayName "Lisa Andrews" "Lisa Andrews" "Lisa Andrews"
PKEY_Identity_LogonStatusString "Iniciado sesión" "Bloqueado" "Iniciar sesión remotamente desde 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}" No predefinida
PKEY_Identity_QualifiedUserName "contoso\lisa" "lisa-pc\lisa" "<nombre> del proveedor de cuentas\lisa@contoso.com"
PKEY_Identity_UserName "contoso\lisa" "lisa" "lisa@contoso.com"

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado credentialprovider.h
Library CredentialProvider.lib
Archivo DLL Authui.dll

Consulte también

ICredentialProviderUser

ICredentialProviderUser::GetValue