IADsServiceOperations

IADsServiceOperations インターフェイスは、IADs を継承するデュアルインターフェイスです。

IADsServiceOperations::Start メソッドは、ネットワークサービスを開始します。

このメソッドは、S_OK を含む標準の戻り値をサポートします。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

IADsServiceOperations::Stop メソッドは、現在アクティブなネットワークサービスを停止します。

このメソッドは、S_OK を含む標準の戻り値をサポートします。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

IADsServiceOperations::Pause メソッドは、IADsServiceOperations::Start メソッドで開始したサービスを一時停止します。

このメソッドは、S_OK を含む標準の戻り値をサポートします。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

IADsServiceOperations::Continue メソッドは、IADsServiceOperations::Pause メソッドで一時停止したサービス操作を再開します。

このメソッドは、S_OK を含む標準の戻り値をサポートします。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

IADsServiceOperations::SetPassword メソッドは、サービスマネージャーが使用するアカウントのパスワードを設定します。このメソッドは、このサービスのセキュリティコンテキストが作成されるときに呼び出されます。

このメソッドは、S_OK を含む標準の戻り値をサポートします。その他の戻り値の詳細については、ADSI Error Codes を参照してください。

IADsService::get_ServiceAccountName プロパティは、このパスワードを設定する対象のアカウントを識別します。

例

次のコード例は、Windows 2000 で実行されている Microsoft Fax Service にパスワードを設定する方法を示しています。

Dim cp As IADsComputer
Dim so As IADsServiceOperations
Dim s As IADsService
Dim sPass As String

On Error GoTo Cleanup

Set cp = GetObject("WinNT://myMachine,computer")
Set so = cp.GetObject("Service", "Fax")
' Insert code to securely retrieve a new password from the user.
so.SetPassword sPass
 
Set s = so
MsgBox "The password for " & so.name & " has been changed on "_
        & s.ServiceAccountName

Cleanup:
    If (Err.Number<>0) Then
        MsgBox("An error has occurred. " & Err.Number)
    End If
    Set cp = Nothing
    Set so = Nothing
    Set s = Nothing

次のコード例は、Windows 2000 で実行されている Microsoft Fax Service にパスワードを設定する方法を示しています。

HRESULT SetServicePassword(LPCWSTR pwszADsPath, LPCWSTR, pwszPasword)
{
    IADsContainer *pCont = NULL;
    IADsServiceOperations *pSrvOp = NULL;
    IDispatch *pDisp = NULL;
    HRESULT hr = S_OK;

    hr = ADsGetObject(pwszADsPath, IID_IADsContainer, (void**)&pCont);
    if(FAILED(hr)) 
    {
        goto Cleanup;
    }

    hr = pCont->GetObject(CComBSTR("Service"), CComBSTR("Fax"), &pDisp);
    if(FAILED(hr)) 
    {
        goto Cleanup;
    }

    hr = pDisp->QueryInterface(IID_IADsServiceOperations, (void**)&pSrvOp);
    if(FAILED(hr)) 
    {
        goto Cleanup;
    }

    // Insert code to securely retrieve the password from the user.
    hr = pSrvOp->SetPassword(CComBSTR(pwszPassword));

Cleanup:
    if(pDisp) 
    {
        pDisp->Release();
    }
    if(pCont) 
    {
        pCont->Release();
    }
    if(pSrvOp) 
    {
        pSrvOp->Release();
    }
}