SecMakeSPNEx-Funktion (ntifs.h)

Artikel
12/21/2024

SecMakeSPNEx erstellt eine Zeichenfolge des Dienstanbieternamens, die bei der Kommunikation mit bestimmten Sicherheitsdienstanbietern verwendet werden kann.

Syntax

KSECDDDECLSPEC NTSTATUS SecMakeSPNEx(
  [in]            IN PUNICODE_STRING     ServiceClass,
  [in]            IN PUNICODE_STRING     ServiceName,
  [in]            IN PUNICODE_STRING     InstanceName,
  [in, optional]  IN USHORT              InstancePort,
  [in, optional]  IN PUNICODE_STRING     Referrer,
  [in, optional]  IN PUNICODE_STRING     TargetInfo,
  [in, out]       IN OUT PUNICODE_STRING Spn,
  [out, optional] OUT PULONG             Length,
  [in]            IN BOOLEAN             Allocate
);

Parameter

[in] ServiceClass

Ein Zeiger auf eine Unicode-Zeichenfolge, die die Dienstklasse für den Sicherheitsdienstanbieter angibt.

[in] ServiceName

Ein Zeiger auf eine Unicode-Zeichenfolge, die den Dienstnamen für den Sicherheitsdienstanbieter angibt.

[in] InstanceName

Ein Zeiger auf eine optionale Unicode-Zeichenfolge, die den Instanznamen für die Verbindung mit dem Sicherheitsdienstanbieter angibt.

[in, optional] InstancePort

Portnummer für eine Instanz des Diensts. Verwenden Sie 0 für den Standardport. Wenn dieser Parameter null ist, enthält der SPN keine Portnummer.

[in, optional] Referrer

Zeiger auf eine konstante null-beendete Zeichenfolge, die den DNS-Namen des Hosts angibt, der eine IP-Adressverweisung gegeben hat. Dieser Parameter wird ignoriert, es sei denn, der parameter ServiceName gibt eine IP-Adresse an.

[in, optional] TargetInfo

Ein Zeiger auf eine mit Null beendete Zeichenfolge, die das Ziel des Kontexts angibt.

[in, out] Spn

Ein Zeiger auf eine Unicode-Zeichenfolge zum Speichern der von dieser Funktion erstellten Zeichenfolge für den Namen des Sicherheitsdienstanbieters.

[out, optional] Length

Zeiger auf eine ULONG, die die tatsächliche Länge des erstellten SPN erhält, einschließlich des endenden Nullzeichens.

[in] Allocate

Eine boolesche Variable, die angibt, ob der Speicher zum Speichern der Spn Unicode-Zeichenfolge von dieser Funktion zugewiesen werden soll. Wenn dieser Parameter "true" ist, wird speicher für Spn aus dem ausgelagerten Pool zugewiesen.

Rückgabewert

SecMakeSPNEx- gibt STATUS_SUCCESS bei Erfolg oder einer der folgenden Fehlercodes für Fehler zurück.

Rückgabecode	Beschreibung
STATUS_BUFFER_OVERFLOW	Der parameter "Zuweisen" wurde auf "false" festgelegt, und eine der folgenden Bedingungen ist aufgetreten: (1) Der Spn Parameter war ein NULL-Zeiger. (2) Die maximale Länge für den Spn Unicode-Zeichenfolgenparameter war zu klein.
STATUS_INVALID_PARAMETER	Die Gesamtlänge des Spn--Parameters überschreitet 65535 Byte.
STATUS_NO_MEMORY	Der parameter "Zuweisen" wurde auf "true" festgelegt, die Speicherzuweisungsanforderung ist jedoch fehlgeschlagen.

Bemerkungen

SecMakeSPNEx ist eine erweiterte Version von SecMakeSPN.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Diese Funktion ist nur Windows XP.
Zielplattform-	Universal
Header-	ntifs.h (einschließlich Ntifs.h, FltKernel.h)
Library	Ksecdd.lib
IRQL-	<= APC_LEVEL

Siehe auch

SecMakeSPN-

SecMakeSPNEx2-

Freigeben über