DDRAddString

La DDRAddString función, en Configuration Manager, agrega una propiedad de cadena al registro de detección de datos (DDR).

Sintaxis

[IDL]
HRESULT DDRAddString();

Parámetros

Name Nombre de la propiedad de la clase.

sValue Valor asignado a la propiedad. Solo puede escribir valores de cadena del juego de caracteres de un byte.

nSQLWidth Longitud máxima de una cadena que se puede asignar a esta propiedad. Este valor no incluye el carácter nulo. Para SMS 2003: Este valor no puede ser mayor que 900 caracteres. Para SMS 2.0, este valor no puede ser mayor que 255 caracteres.

Flags Características del inmueble, como un campo clave para las comparaciones. Especifica una o varias de las siguientes marcas, o un cero.

Flag	Descripción
ADDPROP_GUID (hexadecimal 2)	Identifica una propiedad constante e identifica de forma única el elemento detectado. Si se especifica para los DDR del sistema, debe ser el SMSID generado por el cliente de Configuration Manager. Esta marca solo se usa en la SMSUniqueIdentifier propiedad. Si usa ADDPROP_GUID, también debe usar ADDPROP_KEY. SMSUniqueIdentifier relaciona los datos de detección con los datos de inventario. Si no recopila información de inventario para este recurso, no es necesario que especifique la propiedad en su SMSUniqueIdentifierDDR.
ADDPROP_KEY (Hexadecimal 8)	Identifica esta propiedad como un campo clave durante una comparación de este DDR con instancias de clase en la base de datos. Si una instancia de la base de datos coincide con los datos de las propiedades de la clave DDR, la instancia se actualiza; De lo contrario, se creará una nueva instancia.
ADDPROP_NAME (Hexadecimal 44)	Indica al Administrador de detección de datos (DDM) que use el valor de cadena de esta propiedad para el valor de la Namepropiedad. La Name propiedad es una de las otras seis propiedades que genera el DDM.
ADDPROP_NAME2 (Hexadecimal 84)	Agrega una Comment propiedad a su DDR y usa el valor de cadena de su propiedad para su valor.

Valores devueltos

Si la función se realiza correctamente, el valor devuelto es S_OK.

Si no se ha llamado a la función DDRNew , el valor devuelto es S_FALSE.

Comentarios

El DDR debe contener una propiedad de cadena que especifique la marca de ADDPROP_NAME. El valor debe identificar el recurso de forma única porque la Name propiedad se utiliza normalmente para consultar datos de recursos.

El DDR se rechaza si sValue es más largo que la longitud máxima especificada en nSQLWidth.

Puede usar guiones bajos, concatenación o espacios para nombres de propiedad que contengan varias palabras. Por ejemplo, puede especificar sName como License_Number, LicenseNumbero LicenseNumber. Si especifica sName como LicenseNumber, DDM concatena las palabras, lo que da como LicenseNumberresultado . Sin embargo, el nombre de columna, que se crea en la base de datos, es License_Number. Debe utilizar la misma convención cuando agregue DDR que creen o actualicen instancias en una clase de recursos existente.

Requisitos

Requisitos del entorno de ejecución

smsrsgenctl.dll

smsrsgen.dll

Para obtener más información, consulta Requisitos de tiempo de ejecución del servidor de Configuration Manager.

Requisitos de desarrollo

Para obtener más información, consulta Requisitos de desarrollo del servidor de Configuration Manager.

Consulta también

DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum EnumeraciónSMSResGen Clase de automatización COMInterfaz ISMSResGen