Windows Media Services SDK banner art
PreviousNext

FtsRevokeStatusCallback Method

Revokes a registered transfer progress notification request callback.

Syntax

NSFile.FtsRevokeStatusCallback( Cur, Per, Data, Tot, Pack, Drop, Corr, Bogus, Dup, Flags )

Parameters

Cur

The number of file data bytes that are transferred before each notification occurs. This does not include file header bytes or other non-data file information, such as redundancy bytes. For example, specifying 8192 revokes an FtsOnTransferProgress notification for every 8 KB of file data bytes that are transferred.

Per

The percent of file data bytes that are transferred before each notification occurs. This does not include file header bytes or other non-data file information. such as redundancy bytes. For example, specifying 10 revokes an FtsOnTransferProgress notification for every 10 percent of the file data bytes transferred.

Data

The total data bytes (for all files requested) that are transferred before each notification occurs. This does not include file header bytes or other non-data file information. such as redundancy bytes. For example, specifying 8192 revokes an FtsOnTransferProgress notification for every 8 KB of file data bytes transferred, even if this included more than one file.

Tot

Total bytes (for all files requested) that are transferred before each notification occurs, including file header bytes or other non-data file information, such as redundancy bytes. For example, specifying 8192 revokes an FtsOnTransferProgress notification for every 8 KB of file bytes transferred, even if this included more than one file.

Pack

Number of packets that are transferred before each notification occurs. For example, specifying 100 revokes an FtsOnTransferProgress notification for every 100 packets transferred.

Drop

Number of packets that are dropped before each notification occurs. For example, specifying 50 revokes an FtsOnTransferProgress notification for every 50 packets dropped.

Corr

Number of packets that are corrected before each notification occurs. For example, specifying 25 revokes an FtsOnTransferProgress notification for every 25 packets received and corrected.

Bogus

Number of bogus packets that are received before each notification occurs. For example, specifying 25 revokes an FtsOnTransferProgress notification for every 25 bogus packets received. A bogus packet is a packet that is received on the same IP address and port as the receiver is listening for, but is not part of an expected file transfer operation. For example, this happens if, while a file transfer is taking place, the receiving address starts getting audio packets on the same address.

Dup

Number of duplicate packets that are received before each notification occurs. For example, specifying 5 revokes an FtsOnTransferProgress notification for every five duplicate packets received.

Flags

The following flags are used by this method to define the type of notification request you want to revoke. Multiple flags can be used on each revoke request. If 0 (zero) is specified, the File Transfer object defaults to a “Transfer completed” notification (the same value as 8).

Value Description
0 Notification revoked for a completed transfer operation (same as 8).
4 Notification revoked for the start of a transfer operation.
8 Notification revoked for a completed transfer operation (same as 0).
16 Notification revoked for the start of each file transfer operation.
32 Notification revoked for a completed transfer operation for each file.
64 Notification revoked for any change in the status of the file transfer.

Return Values

This method does not return a value. However, this object does return a Microsoft COM HRESULT error code to the Error object inVBScript.

The following codes are passed to the Error object.

Decimal value Mnemonic Description
0 S_OK The action requested was successful.
1 S_FALSE The action requested is already taking place. 
-2147467259 E_FAIL The action requested cannot take place for an unspecified reason.
-2147024809 E_INVALIDARG The action requested cannot take place because an invalid argument was supplied.

PreviousNext


© 1996-1999 Microsoft Corporation. All rights reserved.