DDRAddStringArray
The DDRAddStringArray function adds a string array property to the discovery data record.
HRESULT DDRAddStringArray(
char *sName,
char *sArray[],
int nArraySize,
int nSQLWidth,
DWORD dwFlags
);
[Visual Basic]
Resource.DDRAddStringArray( _
ByVal sName As String _
ByVal sArray() As String _
ByVal nSQLWidth As Long _
ByVal dwFlags As Long _
)
Parameters
- sName
Name of the class property. - sArray
Array of strings assigned to the property. You can only enter string values from the single-byte character set. - nArraySize[C/C++]
Number of elements in sArray. - nSQLWidth
Maximum length of a string that can be assigned to this property. This value does not include the NULL character. - dwFlags
Characteristics of the property, such as a key field used for comparisons. Enter the following flag or a zero.Flag Description ADDPROP_KEY (Hex 8) Identifies this property as a key field during a comparison of this DDR with class instances in the database. If an instance in the database matches the data of the DDR key properties, the instance is updated; otherwise, a new instance is created.
Return Values
If the function succeeds, the return value is S_OK.
If the DDRNew function has not been called, the return value is S_FALSE.
Remarks
Strings longer than the maximum length specified in nSQLWidth are truncated.
You can use underscores, concatenation, or spaces for property names that contain multiple words. For example, you can specify sName as License_Number, LicenseNumber, or License Number. If you specify sName as License Number, the DDM concatenates the words, which results in LicenseNumber. However, the column name, created in the database, is License_Number. You must use the same convention when you add DDRs that create or update instances in an existing resource class.
Requirements
** Windows NT/2000:** Requires Windows NT 4.0 or later.
** Windows 95/98:** Requires Windows 95 or later.
** Version:** Requires SMS 2.0.
** Header:** Declared in SMSRsGen.h.
** Library:** Included as a resource in SMSRsGen.dll (C/C++); SMSRsGenCtl.dll (VB).