Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
A DDRAddString função, no Configuration Manager, adiciona uma propriedade de cadeia ao registo de deteção de dados (DDR).
Sintaxe
[IDL]
HRESULT DDRAddString();
Parâmetros
Name Nome da propriedade de classe.
sValue Valor atribuído à propriedade . Só pode introduzir valores de cadeia a partir do conjunto de carateres de byte único.
nSQLWidth Comprimento máximo de uma cadeia que pode ser atribuída a esta propriedade. Este valor não inclui o caráter NULL. Para SMS 2003 Este valor não pode ter mais de 900 carateres. Para SMS 2.0, este valor não pode ter mais de 255 carateres.
Flags Características da propriedade, como um campo chave para comparações. Introduza um ou mais dos seguintes sinalizadores ou um zero.
| Flag | Descrição |
|---|---|
| ADDPROP_GUID (Hexadecimal 2) | Identifica uma propriedade que é constante e identifica exclusivamente o item detetado. Se especificado para DDRs do sistema, este deve ser o SMSID gerado pelo cliente Configuration Manager. Este sinalizador só é utilizado na SMSUniqueIdentifier propriedade . Se utilizar ADDPROP_GUID, também tem de utilizar ADDPROP_KEY.SMSUniqueIdentifier relaciona os dados de deteção com os dados de inventário. Se não recolher informações de inventário para este recurso, não precisa de especificar a SMSUniqueIdentifierpropriedade no 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 da chave DDR, a instância é atualizada; caso contrário, é criada uma nova instância. |
| ADDPROP_NAME (Hexadecimal 44) | Indica ao Data Discovery Manager (DDM) para utilizar o valor de cadeia desta propriedade para o valor da Namepropriedade.A Name propriedade é uma das seis outras propriedades que são geradas automaticamente pelo DDM. |
| ADDPROP_NAME2 (Hexadecimal 84) | Adiciona uma Comment propriedade ao DDR e utiliza o valor de cadeia da propriedade para o respetivo valor. |
Return Values
Se a função for bem-sucedida, o valor devolvido será S_OK.
Se a função DDRNew não tiver sido chamada, o valor devolvido é S_FALSE.
Comentários
O DDR tem de conter uma propriedade de cadeia que especifique o sinalizador ADDPROP_NAME. O valor tem de identificar exclusivamente o recurso porque a Name propriedade é normalmente utilizada para consultar dados de recursos.
O DDR é rejeitado se sValue for superior ao comprimento máximo especificado em nSQLWidth.
Pode utilizar carateres de sublinhado, concatenação ou espaços para nomes de propriedades que contenham múltiplas palavras. Por exemplo, pode especificar sName como License_Number, LicenseNumberou LicenseNumber. Se especificar sName como LicenseNumber, o DDM concatena as palavras, o que resulta em LicenseNumber. No entanto, o nome da coluna, que é criado na base de dados, é License_Number. Tem de utilizar a mesma convenção quando adicionar DDRs que criam ou atualizam instâncias numa classe de recursos existente.
Requisitos
Requisitos de Runtime
smsrsgenctl.dll
smsrsgen.dll
Para obter mais informações, veja Configuration Manager Server Runtime Requirements (Requisitos de Runtime do Servidor do Configuration Manager).
Requisitos de Desenvolvimento
Para obter mais informações, veja Requisitos de Desenvolvimento do Configuration Manager Server.
Confira também
DDRAddIntegerDDRAddStringArrayDDRPropertyFlagsEnum EnumerationSMSResGen COM Automation ClassISMSResGen Interface