ISmsClient::SetCurrentManagementPoint Method

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 ISmsClient::SetCurrentManagementPoint method, in Configuration Manager, sets the current management point for the client.

[IDL]
HRESULT SetCurrentManagementPoint(
      BSTR sManagementPoint, 
    _SmsClient_MPProtocolEnum eProtocol
);

Parameters

  • sManagementPoint
    Data type: BSTR

    Qualifiers: [in]

    The value to set for the management point. This value is either the computer name or the IP address of the client's assigned management point.

  • eProtocol
    Data type: _SmsClient_MPProtocolEnum

    Qualifiers: [in, optional, defaultvalue(0)]

    The protocol indicating whether the specified management point is a computer name or an IP address. The value must be one of the following values from the SmsClient_MPProtocolEnum enumeration. The default value is SmsClient_MPProtocol_OS.

    Name Actual value Description

    SmsClient_MPProtocol_OS

    0

    The sManamagentPoint parameter contains the computer name of the management point.

    SmsClient_MPProtocol_IP

    1

    The sManamagentPoint parameter contains the IP address of the management point.

Return Value

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

  • S_OK
    The method succeeded.
  • SMSCLIENT_E_NOASSIGNEDSITE
    The client is not currently assigned to a site.
  • WBEM_E_xxxx
    An error occurred updating Windows Management Instrumentation (WMI).

Remarks

The specified management point must belong to the client's currently assigned site.

Local administrator privileges are required to call this 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

SmsClient Client COM Automation Class
Configuration Manager Client Configuration