ndmpsetauthorized.l

网络数据管理协议的开发

.\" Copyright (c) 1996,1997 PDC, Network Appliance. All Rights Reserved.
.\" $Id: ndmpSetAuthorized.l,v 1.3 1997/02/01 09:50:36 tim Exp $
'\"macro stdmacro
.nr X
.TH ndmpSetAuthorized l "02 Jan 1997"
.SH NAME
ndmpSetAuthorized \- mark the NDMP connection as authorized or not
.SH SYNOPSIS
.LP
.nf
.ft 3
#include <ndmp_common.h>
.ft
.fi
.LP
.BI "void ndmpSetAuthorized(NdmpConnection connectionHandle,"
.if n .ti +5n
.BI "bool_t authorized" );
.SH DESCRIPTION
.B ndmpSetAuthorized(\|)
is used by NDMP servers to mark a connection as authorized or
not.
Initially, each NDMP connection is marked as not authorized.
.B ndmpSetAuthorized(\|)
will typically be called by the ndmp_connect_auth request
handler function after validating connection authorization credentials.
.IR connection
is the NDMP connection handle returned by 
.B ndmpCreateConnection(\|)
or 
.B ndmpRun(\|).
.LP
Until a connection is authorized, the message dispatcher will fail
to dispatch all messages that have the auth_required field set
in the message handler table.
.SH "RETURN VALUES"
None.
.SH "SEE ALSO"
.BR ndmpCreateConnection (l)