| 1 | File server object handle | Input | Char(32) |
| 2 | Correlation | Input | Char(3000) |
| 3 | Correlation bytes provided | Input | Binary(4) |
| 4 | Product ID | Input | Char(7) |
| 5 | Access ID | Output | Char(8) |
| 6 | Error code | I/O | Char(*) |
The Assign SNADS File Server Access ID (QZDASNID) API assigns an access ID to a specific file server object (FSO). An access ID lets the system know that a product is currently working with the file server object and that the file server object should not be deleted. An access ID is returned to the caller so that the access can be revoked at a later time. This API also increments the usage count of the FSO by one. Access IDs can be assigned to a particular file server object, and multiple accesses can be assigned at the same time. You can assign an access ID to an FSO 1 through 2 147 483 647 times, which equates to the usage count.
The necessary linkage to the file server object. The value of this parameter should be taken from the FSO handle that was returned on the call to the Create SNADS File Server Object (QZDCRFSO) API.
Information defined by the caller that identifies the file server object or the file server object access ID. For example, the correlation could contain the message identifier of the message attached to the file server object. If the correlation bytes provided field is zero, this indicates that no correlation is to be stored with the FSO.
This field specifies the length of the correlation data.
The identifier of the product that is using the QZDASNID API. The product ID is used together with the access ID to identify the file server object access.
Valid values for this parameter are as follows:
| Product ID | The product ID of a product that is installed on the system. |
| QMSFPRD | The MSF product identifier. This value can be used for all file server objects that are referred to by the MSF messages. |
The identifier used together with the product ID to identify the file server object access.
The structure in which to return error information. For the format of the structure, see Error code parameter.
| Message ID | Error Message Text |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3A0D E | Temporary server error. |
| CPF3A09 E | System error. |
| CPF3A12 E | Interface error. |
| CPF3C90 E | Literal value cannot be changed. |
| CPF3CF1 E | Error code parameter not valid. |
| CPF9872 E | Program or service program &1 in library &2 ended. Reason code &3. |
[ Back to top | Office APIs | APIs by category ]