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 |