CryptCATPutMemberInfo-Funktion (mscat.h)
[Die CryptCATPutMemberInfo-Funktion ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Die CryptCATPutMemberInfo-Funktion weist Arbeitsspeicher für ein Katalogmitglied zu und fügt ihn dem Katalog hinzu.
Syntax
CRYPTCATMEMBER * CryptCATPutMemberInfo(
[in] HANDLE hCatalog,
[in, optional] LPWSTR pwszFileName,
[in] LPWSTR pwszReferenceTag,
[in] GUID *pgSubjectType,
[in] DWORD dwCertVersion,
[in] DWORD cbSIPIndirectData,
[in] BYTE *pbSIPIndirectData
);
Parameter
[in] hCatalog
Ein Handle für den Katalog, der von der Funktion CryptCATOpen oder CryptCATHandleFromStore abgerufen wird.
[in, optional] pwszFileName
Ein Zeiger auf eine NULL-Zeichenfolge für den Katalogdateinamen.
[in] pwszReferenceTag
Ein Zeiger auf eine NULL-Zeichenfolge, die den Namen des Members enthält.
[in] pgSubjectType
Eine GUID für den Betrefftyp des Members.
[in] dwCertVersion
Ein Wert, der die Zertifikatversion angibt.
[in] cbSIPIndirectData
Ein Wert, der die Anzahl der Bytes im Puffer pbSIPIndirectData angibt.
[in] pbSIPIndirectData
Ein Zeiger auf einen Speicherpuffer für sip-indirekte Daten ( Subject Interface Package ).
Rückgabewert
Ein Zeiger auf eine CRYPTCATMEMBER-Struktur , die das zugewiesene Element enthält. Der Aufrufer darf diesen Zeiger oder eines seiner Mitglieder nicht freigeben.
Wenn diese Funktion NULL zurückgibt, können zusätzliche Fehlerinformationen abgerufen werden, indem die GetLastError-Funktion aufgerufen wird. GetLastError gibt einen der folgenden Fehlercodes zurück.
Rückgabecode | Beschreibung |
---|---|
|
Mindestens ein Parameter ist ungültig. |
|
Während des Vorgangs ging dem Betriebssystem der Arbeitsspeicher aus. |
Anforderungen
Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | mscat.h |
Bibliothek | Wintrust.lib |
DLL | Wintrust.dll |