DDRAddString

A DDRAddString função, no Gestor de Configuração, adiciona uma propriedade de cadeia ao registo de descoberta de dados (DDR).

Sintaxe

[IDL]  
HRESULT DDRAddString();  

Parâmetros

Name
Nome da propriedade da classe.

sValue
Valor atribuído à propriedade. Só é possível introduzir valores de cordas a partir do conjunto de caracteres de byte único.

nSQLWidth
Comprimento máximo de uma corda que pode ser atribuída a esta propriedade. Este valor não inclui o carácter NU. Para SMS 2003 Este valor não pode ser superior a 900 caracteres. Para SMS 2.0 este valor não pode ser superior a 255 caracteres.

Flags
Características da propriedade, como um campo chave para comparações. Introduza uma ou mais das seguintes bandeiras ou um zero.

Sinalizador	Descrição
ADDPROP_GUID (Hexadecimal 2)	Identifica uma propriedade constante e identifica de forma única o item descoberto. Se especificado para DDRs de sistema, este deve ser o SMSID gerado pelo cliente Gestor de Configuração. Esta bandeira é usada apenas na SMSUniqueIdentifier propriedade. Se utilizar ADDPROP_GUID, também deve usá ADDPROP_KEY. Nota que SMSUniqueIdentifier relaciona dados de descoberta com dados de inventário. Se não recolher informações de inventário para este recurso, não precisa de especificar a SMSUniqueIdentifier propriedade no seu DDR.
ADDPROP_KEY (Hexadecimal 8)	Identifica esta propriedade como um campo chave durante uma comparação deste DDR com instâncias de classe na base de dados. Se uma instância na base de dados corresponder aos dados das propriedades-chave do DDR, o caso é atualizado; caso contrário, um novo exemplo é criado.
ADDPROP_NAME (Hexadecimal 44)	Diz ao Data Discovery Manager (DDM) que utilize o valor de cadeia desta propriedade para o valor do Name imóvel. A Name propriedade é uma das seis propriedades adicionais que são geradas para si pelo DDM.
ADDPROP_NAME2 (Hexadecimal 84)	Adiciona um Comment imóvel ao seu DDR e utiliza o valor de cadeia da sua propriedade pelo seu valor.

Valores de devolução

Se a função tiver sucesso, o valor de retorno é S_OK.

Se a função DDRNew não tiver sido chamada, o valor de retorno é S_FALSE.

Observações

O seu DDR deve conter uma propriedade de corda que especifique a bandeira ADDPROP_NAME. O valor deve identificar exclusivamente o recurso porque a Name propriedade é normalmente usada para consultar dados de recursos.

O DDR é rejeitado se sValue for superior ao comprimento máximo especificado em nSQLWidth .

Você pode usar sublinhados, concatenação ou espaços para nomes de propriedade que contêm várias palavras. Por exemplo, pode especificar sName como , ou . License_Number LicenseNumber LicenseNumber . Se especificar sName como LicenseNumber , o DDM concatena as palavras, que resulta em LicenseNumber . No entanto, o nome da coluna, que é criado na base de dados, é License_Number . Deve utilizar a mesma convenção quando adicionar DDRs que criam ou atualizam casos numa classe de recursos existente.

Requisitos

Requisitos de Tempo de Execução

smsrsgenctl.dll

smsrsgen.dll

Para obter mais informações, consulte Configuration Manager Server Runtime Requirements (Requisitos de Tempo de Execução do Servidor do Configuration Manager).

Requisitos de Desenvolvimento

Para obter mais informações, consulte Configuration Manager Server Development Requirements (Requisitos de Desenvolvimento do Servidor do Configuration Manager).

Consulte também

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum Enumeração
Aula de Automação SMSResGen COM
ISMSResGen Interface