DsUnquoteRdnValueA-Funktion (dsparse.h)

Artikel
11/20/2024

Die DsUnquoteRdnValue--Funktion ist ein Clientaufruf, der einen rdN-Wert in Anzeichen zurück in einen nicht zitierten RDN-Wert konvertiert. Da das RDN ursprünglich in Anführungszeichen gesetzt wurde, da er Zeichen enthielt, die beim Eingebetteten in einen distinguished Name (DN) falsch interpretiert werden konnten, sollte der nicht angestellte RDN-Wert nicht als Teil eines DN an den Verzeichnisdienst übermittelt werden, indem verschiedene APIs wie LDAP verwendet werden.

Syntax

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

Parameter

[in] cQuotedRdnValueLength

Die Anzahl der Zeichen in der psQuotedRdnValue Zeichenfolge.

[in] psQuotedRdnValue

Der RDN-Wert, der an zitiert und escapezeichen gesetzt werden kann.

[in, out] pcUnquotedRdnValueLength

Der Eingabewert für dieses Argument ist die maximale Länge in Zeichen psQuotedRdnValue.

Der Ausgabewert für dieses Argument enthält die folgenden Flags.

ERROR_SUCCESS

Dies wird zurückgegeben, wenn die Anzahl der Zeichen mit der Zeichenfolge übereinstimmt, die in psQuotedRdnValueverwendet wird.

ERROR_BUFFER_OVERFLOW

Dies wird zurückgegeben, wenn die Anzahl der Zeichen nicht mit der Zeichenfolge übereinstimmt, die in psQuotedRdnValueverwendet wird.

[out] psUnquotedRdnValue

Der konvertierte, nicht angestellte RDN-Wert.

Rückgabewert

Die folgende Liste enthält die möglichen Werte, die für die funktion DsUnquoteRdnValue zurückgegeben werden.

Bemerkungen

Wenn psQuotedRdnValue zitiert wird:

Die führenden und nachfolgenden Anführungszeichen werden entfernt.
Leerzeichen, bevor das erste Anführungszeichen verworfen wird.
Leerzeichen nach dem letzten Anführungszeichen werden verworfen.
Escapes werden entfernt, und das Zeichen nach dem Escapezeichen wird beibehalten.

Die folgenden Aktionen werden ausgeführt, wenn psQuotedRdnValue nicht angehalten ist:

Der führende Leerraum wird verworfen.
Der nachfolgende Leerraum wird beibehalten.
Escapezeichen ohne Sonderzeichen geben einen Fehler zurück.
Unescaped special characters return an error.
RDN-Werte beginnend mit # (führende Leerzeichen ignorieren) werden als BER-Wert behandelt, der zuvor in eine Zeichenfolge konvertiert und entsprechend konvertiert wurde.
Hexadierte Hexadyten (\89) werden in ein Binäres Byte (0x89) konvertiert.
Escapezeichen werden aus Escapezeichen entfernt.

Die folgenden Aktionen werden immer ausgeführt:

Escapezeichen sind nicht gescapet.
Die RDN-Werte für Eingabe und Ausgabe sind keine Null-beendeten Werte.

Anmerkung

Der Header "dsparse.h" definiert DsUnquoteRdnValue als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista
mindestens unterstützte Server-	Windows Server 2008
Zielplattform-	Fenster
Header-	dsparse.h (include Ntdsapi.h)
Library	Ntdsapi.lib
DLL-	Ntdsapi.dll

Siehe auch

Domänencontroller- und Replikationsverwaltungsfunktionen

DsQuoteRdnValue-

Freigeben über