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 |