Funzione DsQuoteRdnValueA (dsparse.h)
La funzione DsQuoteRdnValue converte un RDN in un valore RDN tra virgolette, se il valore RDN contiene caratteri che richiedono virgolette. La rete RDN tra virgolette può quindi essere inviata come parte di un nome distinto (DN) al servizio directory usando varie API, ad esempio LDAP. Un esempio di RDN che richiederebbe virgolette sarebbe uno con un valore delimitato da virgole, ad esempio un RDN per un nome che usa il formato "last,first".
Sintassi
DSPARSE DWORD DsQuoteRdnValueA(
[in] DWORD cUnquotedRdnValueLength,
[in] LPCCH psUnquotedRdnValue,
[in, out] DWORD *pcQuotedRdnValueLength,
[out] LPCH psQuotedRdnValue
);
Parametri
[in] cUnquotedRdnValueLength
Numero di caratteri nella stringa psUnquotedRdnValue.
[in] psUnquotedRdnValue
Stringa che specifica il valore RDN senza virgolette.
[in, out] pcQuotedRdnValueLength
Numero massimo di caratteri nella stringa psQuotedRdnValue.
I flag seguenti sono l'output per questo parametro.
ERROR_SUCCESS
Indica che il numero corretto di caratteri è stato trovato in psQuotedRdnValue.
ERROR_BUFFER_OVERFLOW
Indica che il numero di caratteri nella stringa non corrisponde psQuotedRdnValue.
[out] psQuotedRdnValue
Stringa che riceve il valore RDN convertito, ad esempio tra virgolette.
Valore restituito
L'elenco seguente contiene i valori possibili restituiti per la funzione DsQuoteRdnValue
Osservazioni
Le virgolette non vengono aggiunte alla rete RDN se non sono necessarie. In questo caso, il valore RDN di output corrisponde al valore RDN di input.
Quando è necessaria la citazione, il nome RDN viene racchiuso tra virgolette in base alla specifica "Lightweight Directory Access Protocol (v3): rappresentazione di stringa UTF-8 dei nomi distinti", RFC 2253.
I valori RDN di input e output non sono stringhe NULLcon terminazione.
Per ripristinare le modifiche apportate da questa chiamata, chiamare la funzione DsUnquoteRdnValue
Nota
L'intestazione dsparse.h definisce DsQuoteRdnValue come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| server minimo supportato | Windows Server 2008 |
| piattaforma di destinazione | Finestre |
| intestazione |
dsparse.h (include Ntdsapi.h) |
| libreria |
Ntdsapi.lib |
| dll | Ntdsapi.dll |