SspiPrepareForCredWrite function

Generates values from an identity structure that can be passed as the values of parameters in a call to the CredWrite function.

Syntax

SECURITY_STATUS SspiPrepareForCredWrite(
  _In_  PSEC_WINNT_AUTH_IDENTITY_OPAQUE AuthIdentity,
  _In_  PCWSTR                          pszTargetName,
  _Out_ PULONG                          pCredmanCredentialType,
  _Out_ PCWSTR                          *ppszCredmanTargetName,
  _Out_ PCWSTR                          *ppszCredmanUserName,
  _Out_ PUCHAR                          *ppCredentialBlob,
  _Out_ PULONG                          pCredentialBlobSize
);

Parameters

AuthIdentity [in]

The identity structure from which to generate the credentials to be passed to the CredWrite function.

pszTargetName [in]

A target name that can be modified by this function depending on the value of the AuthIdentity parameter.

Set the value of this parameter to NULL to use the user name as the target.

pCredmanCredentialType [out]

The credential type to pass to the CredWrite function.

ppszCredmanTargetName [out]

The target name to pass to the CredWrite function.

ppszCredmanUserName [out]

The user name to pass to the CredWrite function.

ppCredentialBlob [out]

The credential BLOB to send to the CredWrite function.

pCredentialBlobSize [out]

The size, in bytes, of the ppCredentialBlob buffer.

Return value

If the function succeeds, it returns SEC_E_OK.

If the function fails, it returns a nonzero error code.

Requirements