Método IADsServiceOperations::SetPassword (iads.h)

El método IADsServiceOperations::SetPassword establece la contraseña de la cuenta usada por el administrador de servicios. Se llama a este método cuando se crea el contexto de seguridad de este servicio.

Sintaxis

HRESULT SetPassword(
  [in] BSTR bstrNewPassword
);

Parámetros

[in] bstrNewPassword

Cadena Unicode terminada en null que se va a almacenar como la nueva contraseña.

Valor devuelto

Este método admite los valores devueltos estándar, incluidos los S_OK. Para obtener más información sobre otros valores devueltos, consulta Códigos de error ADSI.

Comentarios

La propiedad IADsService::get_ServiceAccountName identifica la cuenta para la que se va a establecer esta contraseña.

Ejemplos

En el ejemplo de código siguiente se muestra cómo establecer una contraseña para el servicio de fax de Microsoft que se ejecuta en Windows 2000.

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

En el ejemplo de código siguiente se muestra cómo establecer una contraseña para el servicio de fax de Microsoft que se ejecuta en Windows 2000.

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();
    }
}

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	iads.h
Archivo DLL	Activeds.dll

Consulte también

IADsService

IADsService::get_ServiceAccountName

IADsServiceOperations