ISmsClient2::GetCurrentManagementPointEx Method

  • Article

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.

See Also

Concepts

ISmsClient2 Client COM Automation Interface
Configuration Manager Client Configuration