Función CredGetTargetInfoA (wincred.h)

  • Artículo

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 funciones CredReadDomainCredentials y 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 desde 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é un TargetInfo para su recuperación posterior por CredGetTargetInfo mediante una llamada 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 encuentra ninguna información de destino para la resolución de nombres TargetName 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 TargetName a otro nivel 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 incluidos 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.

Comentarios

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wincred.h
Library Advapi32.lib
Archivo DLL Advapi32.dll

Consulte también

CredFree

CredReadDomainCredentials

CredWriteDomainCredentials

Obtener último error