Функция CredUnmarshalCredentialA (wincred.h)

Статья
11/20/2024

Функция CredUnmarshalCredential преобразует маршалированные учетные данные обратно в исходную форму.

Синтаксис

BOOL CredUnmarshalCredentialA(
  [in]  LPCSTR             MarshaledCredential,
  [out] PCRED_MARSHAL_TYPE CredType,
  [out] PVOID              *Credential
);

Параметры

[in] MarshaledCredential

Указатель на строку, завершающуюся значением NULL, которая содержит маршалированные учетные данные.

[out] CredType

Тип учетных данных, указанных MarshaledCredential.

Это одно из CRED_MARSHAL_TYPE значений.

[out] Credential

Указатель на немаршализованные учетные данные. Если CredType возвращает CertCredential, возвращаемый указатель — это структура CERT_CREDENTIAL_INFO. Если CredType возвращает UsernameTargetCredential, возвращаемый указатель — это структура USERNAME_TARGET_CREDENTIAL_INFO.

Вызывающий объект должен освободить возвращенный буфер с помощью CredFree.

Возвращаемое значение

Эта функция возвращает TRUE при успешном выполнении и FALSE при сбое. Функцию getLastError можно вызвать , чтобы получить более конкретный код состояния. Можно вернуть следующий код состояния:

ERROR_INVALID_PARAMETER

МаршалеedCredential недопустимы.

Замечания

Заметка

Заголовок wincred.h определяет CredUnmarshalCredential как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows XP [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2003 [только классические приложения]
целевая платформа	Виндоус
заголовка	wincred.h
библиотеки	Advapi32.lib
DLL	Advapi32.dll