KspMakeSignatureFn-Rückruffunktion (ntsecpkg.h)
Die SpMakeSignature-Funktion generiert eine Signatur basierend auf der angegebenen Nachricht und dem angegebenen Sicherheitskontext.
Die SpMakeSignature-Funktion ist die Dispatchfunktion für die MakeSignature-Funktion der Security Support Provider Interface.
Syntax
KspMakeSignatureFn Kspmakesignaturefn;
NTSTATUS Kspmakesignaturefn(
[in] LSA_SEC_HANDLE ContextId,
[in] ULONG fQOP,
[in] PSecBufferDesc Message,
[in] ULONG MessageSeqNo
)
{...}
Parameter
[in] ContextId
Ein Handle für den Sicherheitskontext, der zum Generieren der Nachrichtensignatur verwendet werden soll.
[in] fQOP
Gibt paketspezifische Flags an, die die Qualität des Schutzes angeben. Ein Sicherheitspaket kann diesen Parameter verwenden, um die Auswahl kryptografischer Algorithmen zu unterstützen.
[in] Message
Zeiger auf eine SecBuffer-Struktur . Bei der Eingabe enthält die Struktur die zu signierte Nachricht.
[in] MessageSeqNo
Sequenznummer, die der Nachricht zugewiesen werden soll. Sequenznummern sind optional und werden als Schutz vor Verlust und Einfügen von Nachrichten verwendet. Der Wert 0 gibt an, dass Sequenznummern nicht verwendet werden.
Rückgabewert
Wenn die Funktion erfolgreich ist, geben Sie STATUS_SUCCESS zurück.
Wenn die Funktion fehlschlägt, geben Sie einen NTSTATUS-Code zurück, der den Grund für einen Fehler angibt. Im Folgenden werden ein häufiger Fehlergrund und der Fehlercode aufgeführt, den die Funktion zurückgeben soll.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Handle ist ungültig. |
Hinweise
Das Pendant zur SpMakeSignature-Funktion ist die SpVerifySignature-Funktion , die zum Überprüfen von Signaturen am empfangenden Ende verwendet wird.
SSP/APs müssen die SpMakeSignature-Funktion implementieren. Der tatsächliche Name, der der Implementierung zugewiesen wird, liegt jedoch beim Entwickler.
Ein Zeiger auf die SpMakeSignature-Funktion ist in der SECPKG_USER_FUNCTION_TABLE Struktur verfügbar, die von der SpUserModeInitialize-Funktion empfangen wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | ntsecpkg.h |