DsQuoteRdnValueA-Funktion (dsparse.h)

Die DsQuoteRdnValue-Funktion konvertiert einen RDN in einen RDN-Wert in Anführungszeichen, wenn der RDN-Wert Zeichen enthält, die Anführungszeichen erfordern. Das anführungszeichende RDN kann dann als Teil eines distinguished Name (DN) an den Verzeichnisdienst übermittelt werden, indem verschiedene APIs wie LDAP verwendet werden. Ein Beispiel für einen RDN, der Anführungszeichen erfordern würde, wäre ein RDN mit einem durch Trennzeichen getrennten Wert, z. B. ein RDN für einen Namen, der das Format "last,first" verwendet.

Syntax

DSPARSE DWORD DsQuoteRdnValueA(
  [in]      DWORD cUnquotedRdnValueLength,
  [in]      LPCCH psUnquotedRdnValue,
  [in, out] DWORD *pcQuotedRdnValueLength,
  [out]     LPCH  psQuotedRdnValue
);

Parameter

[in] cUnquotedRdnValueLength

Die Anzahl der Zeichen in der Zeichenfolge psUnquotedRdnValue .

[in] psUnquotedRdnValue

Die Zeichenfolge, die den RDN-Wert ohne Anführungszeichen angibt.

[in, out] pcQuotedRdnValueLength

Die maximale Anzahl von Zeichen in der Zeichenfolge psQuotedRdnValue .

Die folgenden Flags sind die Ausgabe für diesen Parameter.

ERROR_SUCCESS

Gibt an, dass die richtige Anzahl von Zeichen in psQuotedRdnValue gefunden wurde.

ERROR_BUFFER_OVERFLOW

Gibt an, dass die Anzahl der Zeichen in der Zeichenfolge nicht mit psQuotedRdnValue übereinstimmt.

[out] psQuotedRdnValue

Die Zeichenfolge, die den konvertierten und möglicherweise in Anführungszeichen gesetzten RDN-Wert empfängt.

Rückgabewert

Die folgende Liste enthält die möglichen Werte, die für die DsQuoteRdnValue-Funktion zurückgegeben werden.

Hinweise

Anführungszeichen werden dem RDN nicht hinzugefügt, wenn keines erforderlich ist. In diesem Fall ist der RDN-Ausgabewert identisch mit dem RDN-Wert der Eingabe.

Wenn ein Zitat erforderlich ist, wird der RDN gemäß der Spezifikation "Lightweight Directory Access Protocol (v3): UTF-8 String Representation of Distinguished Names", RFC 2253, zitiert.

Die RDN-Werte für Eingabe und Ausgabe sind keine NULL-beendeten Zeichenfolgen.

Rufen Sie die DsUnquoteRdnValue-Funktion auf, um die von diesem Aufruf vorgenommenen Änderungen zu rückgängig machen.

Hinweis

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

Anforderungen

Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	dsparse.h (einschließen von Ntdsapi.h)
Bibliothek	Ntdsapi.lib
DLL	Ntdsapi.dll

Weitere Informationen

Domänencontroller und Replikationsverwaltungsfunktionen

DsUnquoteRdnValue