Funzione SetNetScheduleAccountInformation (atacct.h)

Articolo
02/23/2024

[SetNetScheduleAccountInformation non è più disponibile per l'uso a partire da Windows 8. Usare invece le interfacce dell'utilità di pianificazione 2.0.

]

La funzione SetNetScheduleAccountInformation imposta il nome e la password dell'account del servizio AT. Il nome e la password dell'account del servizio AT vengono usati come credenziali per i processi pianificati creati con NetScheduleJobAdd.

Sintassi

HRESULT SetNetScheduleAccountInformation(
  [in] LPCWSTR pwszServerName,
  [in] LPCWSTR pwszAccount,
  [in] LPCWSTR pwszPassword
);

Parametri

[in] pwszServerName

Stringa di caratteri wide con terminazione NULL per il nome del computer le cui informazioni sull'account vengono impostate.

[in] pwszAccount

Puntatore a una stringa di caratteri wide con terminazione NULL per l'account. Per specificare l'account di sistema locale, impostare questo parametro su NULL.

[in] pwszPassword

Puntatore a una stringa di caratteri wide con terminazione NULL per la password. Per informazioni sulla protezione delle informazioni sulle password, vedere Gestione delle password.

Valore restituito

Il valore restituito è HRESULT. Un valore di S_OK indica che il nome e la password dell'account sono stati impostati correttamente. Qualsiasi altro valore indica una condizione di errore.

Se la funzione ha esito negativo, di seguito sono elencati alcuni dei possibili valori restituiti.

Codice/valore restituito	Descrizione
E_ACCESSDENIED 0x080070005	Accesso negato. Questo errore viene restituito se il chiamante non è membro del gruppo Administrators. Questo errore viene restituito anche se il parametro pwszAccount non è NULL che indica un account denominato non l'account di sistema locale e il parametro pwszPassword non è corretto per l'account specificato nel parametro pwszAccount .
HRESULT_FROM_WIN32(ERROR_INVALID_DATA) 0x08007000d	I dati non sono validi. Questo errore viene restituito se il parametro pwszPassword è NULL o la lunghezza della stringa di parametro pwszPassword è troppo lunga.
SCHED_E_ACCOUNT_NAME_NOT_FOUND 0x80041310	Impossibile stabilire l'esistenza dell'account specificato. Questo errore viene restituito se il parametro pwszAccount non era NULL che indica un account denominato non l'account di sistema locale e il parametro pwszAccount non è stato trovato.

Commenti

SetNetScheduleAccountInformation rappresenta il chiamante. Solo i membri del gruppo Administrators locale nel computer in cui vengono impostate le informazioni sull'account di pianificazione possono eseguire correttamente questa funzione. Si noti che le password NULL non sono consentite.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista, Windows XP con SP1 [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	atacct.h
Libreria	Mstask.lib
DLL	Mstask.dll

Vedi anche

GetNetScheduleAccountInformation

Condividi tramite