Funzione SspiPromptForCredentialsW (sspi.h)

Consente a un'applicazione SSPI ( Security Support Provider Interface ) di richiedere a un utente di immettere le credenziali.

Sintassi

unsigned long SEC_ENTRY SspiPromptForCredentialsW(
  [in]                PCWSTR                          pszTargetName,
  [in]                PCREDUI_INFOW                   pUiInfo,
  [in]                unsigned long                   dwAuthError,
  [in]                PCWSTR                          pszPackage,
  [in]                PSEC_WINNT_AUTH_IDENTITY_OPAQUE pInputAuthIdentity,
  [out]               PSEC_WINNT_AUTH_IDENTITY_OPAQUE *ppAuthIdentity,
  [in, out, optional] int                             *pfSave,
  [in]                unsigned long                   dwFlags
);

Parametri

[in] pszTargetName

Nome della destinazione da utilizzare.

[in] pUiInfo

Puntatore a una struttura CREDUI_INFO che contiene informazioni per personalizzare l'aspetto della finestra di dialogo visualizzata da questa funzione.

Se il membro hwndParent della struttura CREDUI_INFO non è NULL, questa funzione visualizza una finestra di dialogo modale centrata sulla finestra padre.

Se il membro hwndParent della struttura CREDUI_INFO è NULL, la funzione visualizza una finestra di dialogo centrata sullo schermo.

Questa funzione ignora il membro hbmBanner della struttura CREDUI_INFO .

[in] dwAuthError

Codice di errore di Windows, definito in Winerror.h, visualizzato nella finestra di dialogo. Se le credenziali raccolte in precedenza non sono valide, il chiamante usa questo parametro per passare il messaggio di errore dall'API che ha raccolto le credenziali (ad esempio, Winlogon) a questa funzione. Il messaggio di errore corrispondente viene formattato e visualizzato nella finestra di dialogo. Impostare il valore di questo parametro su zero per non visualizzare alcun messaggio di errore.

[in] pszPackage

Nome del pacchetto di sicurezza da utilizzare.

[in] pInputAuthIdentity

Struttura di identità utilizzata per popolare i campi delle credenziali nella finestra di dialogo. Per lasciare vuoti i campi delle credenziali, impostare il valore di questo parametro su NULL.

[out] ppAuthIdentity

Struttura di identità che rappresenta le credenziali raccolte da questa funzione.

Al termine dell'uso di questa struttura, liberarlo chiamando la funzione SspiFreeAuthIdentity .

[in, out, optional] pfSave

Puntatore a un valore booleano che, all'input, specifica se la casella di controllo Salva è selezionata nella finestra di dialogo visualizzata da questa funzione. Nell'output, il valore di questo parametro specifica se la casella di controllo Salva è stata selezionata quando l'utente ha fatto clic sul pulsante Invia nella finestra di dialogo. Impostare questo parametro su NULL per ignorare la casella di controllo Salva .

Questo parametro viene ignorato se il flag CREDUIWIN_CHECKBOX non è impostato nel parametro dwFlags .

[in] dwFlags

Flag che determinano il comportamento di questa funzione. Il flag seguente è attualmente definito.

Valore restituito

Se la funzione ha esito positivo, restituisce SEC_E_OK.

Se la funzione ha esito negativo, restituisce un codice di errore diverso da zero.

Commenti

Requisiti