Función CredGetTargetInfoA (wincred.h)

La función CredGetTargetInfo recupera toda la información de nombre de destino conocida del equipo de destino con nombre. Esto se ejecuta localmente y no necesita ningún privilegio determinado. Se espera que la información devuelta se pase a las CredReadDomainCredentials y funciones de CredWriteDomainCredentials. La información no debe utilizarse para ningún otro propósito.

Los paquetes de autenticación calculan targetInfo al intentar autenticarse en un TargetName. Los paquetes de autenticación almacenan en caché esta información de destino para que esté disponible para CredGetTargetInfo. Por lo tanto, la información de destino solo estará disponible en un intento reciente de autenticar un TargetName.

Los paquetes de autenticación que no están en el proceso de LSA pueden almacenar en caché una TargetInfo para su recuperación posterior mediante credGetTargetInfo llamando a CredReadDomainCredentials con la marca CRED_CACHE_TARGET_INFORMATION.

Sintaxis

BOOL CredGetTargetInfoA(
  [in]  LPCSTR                          TargetName,
  [in]  DWORD                           Flags,
  [out] PCREDENTIAL_TARGET_INFORMATIONA *TargetInfo
);

Parámetros

[in] TargetName

Puntero a una cadena terminada en NULL que contiene el nombre del equipo de destino para el que se va a recuperar la información.

[in] Flags

Marcas que controlan la operación de la función. Se puede usar la marca siguiente:

CRED_ALLOW_NAME_RESOLUTION

Si no se puede encontrar información de destino para TargetName resolución de nombres se realiza en TargetName para convertirlo en otros formularios. Si existe información de destino para cualquiera de esos otros formularios, se devuelve. Actualmente solo se realiza la resolución de nombres DNS.

Esto resulta útil si la aplicación no llama directamente a un paquete de autenticación. La aplicación puede pasar el TargetName a otra capa de software para autenticarse en el servidor y esa capa de software podría resolver el nombre y pasar el nombre resuelto al paquete de autenticación. Por lo tanto, no habrá información de destino para el TargetName original.

[out] TargetInfo

Puntero a un único búfer de bloque asignado para contener la información de destino. Al menos uno de los miembros devueltos de targetInfo no será NULL. Los punteros contenidos en el búfer son punteros a ubicaciones dentro de este único bloque asignado. El único búfer devuelto debe liberarse llamando a CredFree.

Valor devuelto

La función devuelve TRUE si se ejecuta correctamente y FALSE en caso de error. Se puede llamar a la función getLastError para obtener un código de estado más específico. Se puede devolver el código de estado siguiente:

• ERROR_NOT_FOUND

  La información de destino del servidor con nombre no está disponible.

Observaciones

Nota

El encabezado wincred.h define CredGetTargetInfo como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	wincred.h
biblioteca de	Advapi32.lib
DLL de	Advapi32.dll

Consulte también

CredFree

CredReadDomainCredentials

credWriteDomainCredentials

GetLastError