ISmsClient::SetCurrentManagementPoint 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 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.

Partager via