Función DsQuoteRdnValueA (dsparse.h)

La función DsQuoteRdnValue convierte un RDN en un valor RDN entre comillas, si el valor de RDN contiene caracteres que requieren comillas. A continuación, el RDN entrecomillado se puede enviar como parte de un nombre distintivo (DN) al servicio de directorio mediante varias API como LDAP. Un ejemplo de RDN que requeriría comillas sería una que tiene un valor separado por comas, como un RDN para un nombre que usa el formato "last,first".

Sintaxis

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

Parámetros

[in] cUnquotedRdnValueLength

Número de caracteres de la cadena psUnquotedRdnValue .

[in] psUnquotedRdnValue

Cadena que especifica el valor RDN sin comillas.

[in, out] pcQuotedRdnValueLength

Número máximo de caracteres de la cadena psQuotedRdnValue .

Las marcas siguientes son la salida de este parámetro.

ERROR_SUCCESS

Indica que se encontró el número correcto de caracteres en psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Indica que el número de caracteres de la cadena no coincide con psQuotedRdnValue.

[out] psQuotedRdnValue

Cadena que recibe el valor convertido, y tal vez entrecomillado, RDN.

Valor devuelto

La lista siguiente contiene los valores posibles devueltos para la función DsQuoteRdnValue .

Comentarios

Las comillas no se agregan al RDN si no se requiere ninguna. En este caso, el valor RDN de salida es el mismo que el valor de RDN de entrada.

Cuando se requiere comillas, el RDN se cita de acuerdo con la especificación "Protocolo ligero de acceso a directorios (v3): Representación de cadena UTF-8 de nombres distintivos", RFC 2253.

Los valores RDN de entrada y salida no son cadenas terminadas en NULL.

Para revertir los cambios realizados por esta llamada, llame a la función DsUnquoteRdnValue .

Nota:

El encabezado dsparse.h define DsQuoteRdnValue como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	dsparse.h (incluya Ntdsapi.h)
Library	Ntdsapi.lib
Archivo DLL	Ntdsapi.dll

Consulte también

Funciones de administración de replicación y controlador de dominio

DsUnquoteRdnValue