CommandLine

[The CurrentDirectory property is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Describes the command-line used to invoke the application when it is started. The following table summarizes the attributes of the CommandLine property.

Attribute Value
Data type Null-terminated Unicode string
Access Read/write
Status Required
Structure CLUSPROP_SZ
Maximum None (but see Maximum Property Size.)
Default NULL

Remarks

The CLUSPROP_SZ_DECLARE macro creates a CLUSPROP_SZ structure with an array of the correct size.

Examples

The property value portion of a property list entry for CommandLine can be set with the following example code.

WCHAR                szCommandLineData[] = L"C:\\Bin\\MyApp.exe";
CLUSPROP_SZ_DECLARE( CommandLineValue, 
                     sizeof( szCommandLineData ) / sizeof( WCHAR ) );

CommandLineValue.Syntax.dw = CLUSPROP_SYNTAX_LIST_VALUE_SZ;
CommandLineValue.cbLength  = sizeof( szCommandLineData );
StringCbCopy( CommandLineValue.sz, 
              CommandLineValue.cbLength, 
              szCommandLineData );

Requirements

Minimum supported client
None supported
Minimum supported server
Windows Server 2003 Enterprise, Windows Server 2003 Datacenter
End of server support
Windows Server 2003 Datacenter, Windows Server 2003 Enterprise

See also

Generic Application Private Properties

CLUSPROP_SZ

CLUSPROP_SZ_DECLARE