Función CredMarshalCredentialA (wincred.h)

Artículo
03/03/2024

La función CredMarshalCredential transforma una credencial en una cadena de texto. Históricamente, muchas funciones, como NetUseAdd, toman un nombre de dominio, un nombre de usuario y una contraseña como credenciales. Estas funciones no aceptan certificados como credenciales. La función CredMarshalCredential convierte estas credenciales en un formulario que se puede pasar a estas API.

La credencial serialada se debe pasar como la cadena de nombre de usuario a cualquier API que se pase actualmente a las credenciales. El nombre de dominio, si procede, se debe pasar a esa API como NULL o vacío. Para las credenciales de certificado, el PIN del certificado debe pasarse a esa API como contraseña.

El autor de la llamada no debe modificar ni imprimir credenciales serialadas. El valor devuelto se puede convertir libremente entre los conjuntos de caracteres Unicode, ANSI y OEM. La cadena distingue mayúsculas de minúsculas.

Sintaxis

BOOL CredMarshalCredentialA(
  [in]  CRED_MARSHAL_TYPE CredType,
  [in]  PVOID             Credential,
  [out] LPSTR             *MarshaledCredential
);

Parámetros

[in] CredType

Tipo de la credencial que se va a serializar.

[in] Credential

Credencial que se va a serializar.

Se trata de uno de los valores de CRED_MARSHAL_TYPE .

Si CredType es CertCredential, Credential apunta a una estructura de CERT_CREDENTIAL_INFO .

Si CredType es UsernameTargetCredential, Credential apunta a una estructura de USERNAME_TARGET_CREDENTIAL_INFO .

[out] MarshaledCredential

Puntero a una cadena terminada en null que contiene la credencial serialada. El autor de la llamada debe liberar el búfer devuelto mediante CredFree.

Valor devuelto

Esta 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_INVALID_PARAMETER

CredType no es válido.

Comentarios

Nota

El encabezado wincred.h define CredMarshalCredential 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 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