DsQuoteRdnValueA-Funktion (dsparse.h)
Die DsQuoteRdnValue--Funktion wandelt ein RDN in einen rdN-Wert in Anführungszeichen um, wenn der RDN-Wert Zeichen enthält, die Anführungszeichen erfordern. Das zitierte RDN kann dann als Teil eines Distinguished Name (DN) an den Verzeichnisdienst mit verschiedenen APIs wie LDAP übermittelt werden. Ein Beispiel für ein RDN, das Anführungszeichen erfordern würde, wäre eine, die einen durch Trennzeichen getrennten Wert aufweist, 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 psUnquotedRdnValue Zeichenfolge.
[in] psUnquotedRdnValue
Die Zeichenfolge, die den nicht angehaltenen RDN-Wert angibt.
[in, out] pcQuotedRdnValueLength
Die maximale Anzahl von Zeichen in der psQuotedRdnValue Zeichenfolge.
Die folgenden Flags sind die Ausgabe für diesen Parameter.
ERROR_SUCCESS
Gibt an, dass die richtige Anzahl von Zeichen in psQuotedRdnValuegefunden 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 An zitierten RDN-Wert empfängt.
Rückgabewert
Die folgende Liste enthält die möglichen Werte, die für die funktion DsQuoteRdnValue zurückgegeben werden.
Bemerkungen
Anführungszeichen werden dem RDN nicht hinzugefügt, wenn keines erforderlich ist. In diesem Fall entspricht der RDN-Ausgabewert dem Eingabe-RDN-Wert.
Wenn eine Quotierung erforderlich ist, wird das 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 nicht NULL--terminated strings.
Rufen Sie die DsUnquoteRdnValue--Funktion auf, um die von diesem Aufruf vorgenommenen Änderungen wiederhergestellt zu können.
Anmerkung
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 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 |