Funzione DsQuoteRdnValueA (dsparse.h)

Articolo
08/23/2023

La funzione DsQuoteRdnValue converte un RDN in un valore RDN tra virgolette, se il valore RDN contiene caratteri che richiedono virgolette. La rete RDN con 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 che ha 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 a psQuotedRdnValue.

[out] psQuotedRdnValue

Stringa che riceve il valore convertito e forse citato, RDN.

Valore restituito

L'elenco seguente contiene i valori possibili restituiti per la funzione DsQuoteRdnValue .

Commenti

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, la rete RDN viene espressa in base alla specifica "Lightweight Directory Access Protocol (v3): rappresentazione stringa UTF-8 dei nomi distinti", RFC 2253.

I valori RDN di input e output non sono stringhe con terminazione NULL.

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 preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	dsparse.h (include Ntdsapi.h)
Libreria	Ntdsapi.lib
DLL	Ntdsapi.dll

Vedi anche

Funzioni di gestione del controller di dominio e della replica

DsUnquoteRdnValue

Condividi tramite