DDRAddString

함수는 DDRAddString Configuration Manager DDR(데이터 검색 레코드)에 문자열 속성을 추가합니다.

구문

[IDL]  
HRESULT DDRAddString();  

매개 변수

Name
클래스 속성의 이름입니다.

sValue
속성에 할당된 값입니다. 단일 바이트 문자 집합에서만 문자열 값을 입력할 수 있습니다.

nSQLWidth
이 속성에 할당할 수 있는 문자열의 최대 길이입니다. 이 값에는 NULL 문자가 포함되지 않습니다. SMS 2003의 경우 이 값은 900자를 초과할 수 없습니다. SMS 2.0의 경우 이 값은 255자를 초과할 수 없습니다.

Flags
비교를 위한 키 필드와 같은 속성의 특성입니다. 다음 플래그 중 하나 이상 또는 0을 입력합니다.

플래그	설명
ADDPROP_GUID(16진수 2)	상수인 속성을 식별하고 검색된 항목을 고유하게 식별합니다. 시스템 DDR에 대해 지정된 경우 Configuration Manager 클라이언트에서 생성된 SMSID여야 합니다. 이 플래그는 속성에 SMSUniqueIdentifier 만 사용됩니다. ADDPROP_GUID 사용하는 경우 ADDPROP_KEY 사용해야 합니다. 검색 SMSUniqueIdentifier 데이터를 인벤토리 데이터와 관련이 있습니다. 이 리소스에 대한 인벤토리 정보를 수집하지 않는 경우 DDR에서 속성을 지정할 SMSUniqueIdentifier필요가 없습니다.
ADDPROP_KEY(16진수 8)	데이터베이스의 클래스 인스턴스와 이 DDR을 비교하는 동안 이 속성을 키 필드로 식별합니다. 데이터베이스의 인스턴스가 DDR 키 속성의 데이터와 일치하면 인스턴스가 업데이트됩니다. 그렇지 않으면 새 인스턴스가 만들어집니다.
ADDPROP_NAME(16진수 44)	속성 값 Name에 이 속성의 문자열 값을 사용하도록 DDM(Data Discovery Manager)에 지시합니다. 속성은 Name DDM에서 생성한 6개의 추가 속성 중 하나입니다.
ADDPROP_NAME2(16진수 84)	DDR에 Comment 속성을 추가하고 해당 값에 속성의 문자열 값을 사용합니다.

반환 값

함수가 성공하면 반환 값이 S_OK.

DDRNew 함수가 호출되지 않은 경우 반환 값은 S_FALSE.

설명

DDR에는 ADDPROP_NAME 플래그를 지정하는 하나의 문자열 속성이 포함되어야 합니다. 속성은 일반적으로 리소스 Name 데이터를 쿼리하는 데 사용되므로 값은 리소스를 고유하게 식별해야 합니다.

가 에 nSQLWidth지정된 최대 길이보다 긴 경우 sValue DDR이 거부됩니다.

여러 단어를 포함하는 속성 이름에 밑줄, 연결 또는 공백을 사용할 수 있습니다. 예를 들어 , LicenseNumber또는 LicenseNumber로 License_Number지정할 sName 수 있습니다. 을 로 LicenseNumber지정 sName 하면 DDM은 단어를 연결하여 를 생성합니다LicenseNumber. 그러나 데이터베이스에서 만든 열 이름은 입니다 License_Number. 기존 리소스 클래스에서 인스턴스를 만들거나 업데이트하는 DDR을 추가할 때 동일한 규칙을 사용해야 합니다.

요구 사항

런타임 요구 사항

smsrsgenctl.dll

smsrsgen.dll

자세한 내용은 Configuration Manager 서버 런타임 요구 사항을 참조하세요.

개발 요구 사항

자세한 내용은 Configuration Manager 서버 개발 요구 사항을 참조하세요.

참고 항목

DDRAddInteger
DDRAddStringArray
DDRPropertyFlagsEnum 열거형
SMSResGen COM Automation 클래스
ISMSResGen 인터페이스