Función DsUnquoteRdnValueA (dsparse.h)

La función DsUnquoteRdnValue es una llamada de cliente que convierte un valor RDN entre comillas en un valor RDN sin comillas. Dado que el RDN se puso originalmente entre comillas porque contenía caracteres que podían interpretarse erróneamente cuando se incrustaba en un nombre distintivo (DN), el valor RDN sin comillas no se debe enviar como parte de un DN al servicio de directorio mediante varias API como LDAP.

Sintaxis

DSPARSE DWORD DsUnquoteRdnValueA(
  [in]      DWORD cQuotedRdnValueLength,
  [in]      LPCCH psQuotedRdnValue,
  [in, out] DWORD *pcUnquotedRdnValueLength,
  [out]     LPCH  psUnquotedRdnValue
);

Parámetros

[in] cQuotedRdnValueLength

Número de caracteres de la cadena psQuotedRdnValue .

[in] psQuotedRdnValue

Valor RDN que se puede entrecomillar y escapar.

[in, out] pcUnquotedRdnValueLength

El valor de entrada de este argumento es la longitud máxima, en caracteres, de psQuotedRdnValue.

El valor de salida de este argumento incluye las marcas siguientes.

ERROR_SUCCESS

Se devuelve si el número de caracteres coincide con la cadena usada en psQuotedRdnValue.

ERROR_BUFFER_OVERFLOW

Se devuelve si el número de caracteres no coincide con la cadena usada en psQuotedRdnValue.

[out] psUnquotedRdnValue

Valor RDN convertido y sin comprimido.

Valor devuelto

La lista siguiente contiene los valores posibles que se devuelven para la función DsUnquoteRdnValue .

Comentarios

Cuando psQuotedRdnValue está entre comillas:

• Se quitan las comillas iniciales y finales.
• Espacio en blanco antes de descartar la primera cita.
• Se descarta el espacio en blanco al final de la última cita.
• Los escapes se quitan y se mantiene el carácter que sigue al escape.

Las siguientes acciones se realizan cuando psQuotedRdnValue no está comprimido:

• Se descarta el espacio en blanco inicial.
• Se mantiene el espacio en blanco final.
• Los caracteres no especiales con escape devuelven un error.
• Los caracteres especiales sin escape devuelven un error.
• Los valores de RDN que comienzan por # (ignorando el espacio en blanco inicial) se controlan como un valor BER que se ha convertido previamente en una cadena y se convierten en consecuencia.
• Los dígitos hexadecimales de escape (\89) se convierten en un byte binario (0x89).
• Los escapes se quitan de los caracteres especiales de escape.

Siempre se realizan las siguientes acciones:

• Los caracteres especiales con escape están sin escape.
• Los valores RDN de entrada y salida no son valores terminados por null.

Nota:

El encabezado dsparse.h define DsUnquoteRdnValue 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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 controlador de dominio y replicación

DsQuoteRdnValue