ISmsClient2::GetCurrentManagementPointEx Method

Article
05/03/2011

Applies To: System Center Configuration Manager 2007, System Center Configuration Manager 2007 R2, System Center Configuration Manager 2007 R3, System Center Configuration Manager 2007 SP1, System Center Configuration Manager 2007 SP2

The ISmsClient2::GetCurrentManagementPointEx method, in Configuration Manager, gets information about the current management point of the client.

[IDL]
HRESULT GetCurrentManagementPointEx(
      ULONG ulFlags,
      BSTR* sManagementPoint,
      DWORD* pdwVersion,
      BSTR* sCapabilities,
      SmsClient_MPTypeEnum* peMPType
);

Parameters

ulFlags
Data type: ULONG

Qualifiers: [in]

Flags specifying options for retrieval of the management point. Possible values are:

0x0

SMS_CLIENT_GETMP_NO_FLAGS

0x1

SMS_CLIENT_GETMP_INCLUDE_INTERNET

0x2

SMS_CLIENT_GETMP_INCLUDE_PROXY

0x4

SMS_CLIENT_GETMP_INCLUDE_RESIDENT

sManagementPoint
Data type: BSTR

Qualifiers: [in]

The name of the management point.

pdwVersion
Reserved. A non-null value must be passed.

sCapabilities
Reserved. A non-null value must be passed.

peMPType
Data type: SmsClient_MPTypeEnum

Qualifiers: [out]

Pointer to the management point type. Possible values are defined by the SmsClient_MP enumeration, as follows:
- SmsClient_MPType_Unknown
- SmsClient_MPType_Assigned
- SmsClient_MPType_Proxy
- SmsClient_MPType_Resident
- SmsClient_MPType_Internet

Return Value

An HRESULT code. Possible values include, but are not limited to, the following:

S_OK
The method succeeded.

Remarks

The valid types are defined by the input flags (ulFlags). If multiple flags are specified, this method retrieves the first valid type, in this order:

SmsClient_MPType_Internet
SmsClient_MPType_Resident
SmsClient_MPType_Proxy
SmsClient_MPType_Assigned

If no flag is specified, the default value is SmsClient_MPType_Assigned.

This function can be used to obtain management point information when roaming or when on the internet.

This function replaces ISmsClient::GetCurrentManagementPoint Method.

Requirements

smsclient.dll

Runtime Requirements

For more information, see Configuration Manager Client Runtime Requirements.

Development Requirements

For more information, see Configuration Manager Client Development Requirements.

Partager via