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

Статья
08/27/2023

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

Синтаксис

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

Параметры

[in] MarshaledCredential

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

[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

Недопустимый атрибут MarshaledCredential .

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

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Целевая платформа	Windows
Header	wincred.h
Библиотека	Advapi32.lib
DLL	Advapi32.dll