PROPID_PC_DS_ENABLED

  • Article

 

Applies To: Windows 10, Windows 7, Windows 8, Windows 8.1, Windows Server 2008, Windows Server 2008 R2, Windows Server 2012, Windows Server 2012 R2, Windows Server Technical Preview, Windows Vista

(Read-only, introduced in MSMQ 2.0.) The PROPID_PC_DS_ENABLED property indicates whether the Message Queuing service on the local computer is configured to use the directory service and is operating in domain or offline mode.

Property ID

PROPID_PC_DS_ENABLED

Type Indicator

VT_BOOL

MQPROPVARIANT Field

boolVal

Property Value

VARIANT_TRUE (-1)

The Message Queuing service on the local computer is configured to use the directory service and is operating in domain or offline mode.

VARIANT_FALSE (0)

The Message Queuing service on the local computer is not configured to use the directory service and is operating in workgroup mode.

Remarks

To find out whether the Message Queuing service on the local computer is configured to use the directory service, specify PROPID_PC_DS_ENABLED in an MQPRIVATEPROPS structure. Then, call MQGetPrivateComputerInformation and examine the value returned. When retrieving this property, the type indicator can be set to VT_BOOL or VT_NULL. If you set the type indicator to VT_NULL, Message Queuing automatically changes the type indicator to VT_BOOL during the function call.

Message Queuing does not access the directory service to obtain the value of this property.

Equivalent COM Property

When using COM components, you can determine whether Message Queuing is configured to use the directory service using the MSMQApplication.IsDSEnabled property.

Example Code

The following example shows how PROPID_PC_DS_ENABLED is specified in the MQPRIVATEPROPS structure.

aQMPropId[i] = PROPID_PC_DS_ENABLED;   // Property ID  
aQMPropVar[i].vt = VT_BOOL;            // Type indicator  
i++;

The following example is included in Using Message Queuing.

For an example of See
Checking whether the local computer is configured to operate in workgroup mode C/C++ Code Example: Verifying Workgroup Installation

See Also

Private Computer Properties
MQGetPrivateComputerInformation
MQPRIVATEPROPS