MQGetPrivateComputerInformation

 

Updated: July 19, 2016

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

(Introduced in MSMQ 2.0.) The MQGetPrivateComputerInformation function retrieves information about the local computer without accessing the directory service.

HRESULT APIENTRY MQGetPrivateComputerInformation(  
  LPCWSTR lpwcsComputerName,    
  MQPRIVATEPROPS * pPrivateProps           
);  

lpwcsComputerName

[in] Must be set to NULL to specify the local computer.

pPrivateProps

[in, out] Pointer to an MQPRIVATEPROPS structure that specifies which private computer properties to retrieve.

On input, this structure specifies which properties to retrieve.

On output, this structure contains the returned values for the properties and any optional status error codes for the properties (some properties do not return status error codes).

MQ_OK

Indicates success.

MQ_ERROR_INVALID_PARAMETER (0xC00E0006)

One of the input parameters is not valid. For example, lpwcsComputerName is not set to NULL.

MQ_ERROR_ILLEGAL_MQPRIVATEPROPS (0xC00E007B)

Either no properties are specified in the MQPRIVATEPROPS structure, or the pPrivateProps parameter is set to NULL.

This function may be called even when Message Queuing does not have access to a directory service. For example, this function is called to verify that the computer is operating in workgroup mode.

The values of the private computer properties returned by this call are calculated, they are not retrieved from the directory service.

The following code example is included in Using Message Queuing.

For an example ofSee
Verifying that the local computer is configured to operate in workgroup modeC/C++ Code Example: Verifying Workgroup Installation

Windows NT/2000/XP: Included in Windows 2000 and later.

Windows 95/98/Me: Unsupported.

Header: Declared in Mq.h.

Library: Use Mqrt.lib.

Message Queuing Functions
Private Computer Properties
MQPRIVATEPROPS
PROPID_PC_VERSION
PROPID_PC_DS_ENABLED

Community Additions

ADD
Show: